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Svelato il codice di eMule! Ecco cosa si W 

| nasconde dietro al software più usato in rete Q 

\ •architettura la rete edonkey 
e il formato dei messaggi TCP/IP 

\ i/connessione le routine 

per effettuare il login con i server 

i •ricerca i comandi per scovare 

musica, film, software e tutto il resto 

| •dowmload/upload 

come scaricare i file, salvarli sul disco 
e condividerli con gli altri 





RSONAUZZATE 



RwAtK crei un'immagine 

e la grafica di setup che vuoi 
1 , la distribuisci! 



JAVASCRIPT 



INTRODUZIONE 
ADOJO 

Ecco gli esempi per aggiungere 
al tuo sito pagine interattive. 
Anche per chi non è un esperto... 

GRAFICA CON GLI 
SFONDI DINAMICI 

Sfruttiamo i fogli di stile 
per creare "gradienti" al volo 
senza usare photoshop 

UN WORD PROCESSOR 
NEL BROWSER 

Ecco come creare form che 
consentono una raffinata 
formattazione del testo 



METTI WINDOWS 
IN SICUREZZA 

Alla scoperta del Security Configuration Manager: il tool 
per trovare i buchi nella tua installazione e risolverli 

DISEGNA SUBITO CON .NET 3.0 

Con Windows Presentation Foundation tutto è vettoriale. Ecco la guida 
per realizzare facilmente la tua prima applicazione con grafica animata 
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le librerie 
usate da yahoo 



ARRIVA DERBY 
IL DB EMBEDDED 



Introduzione a YUI: il framework Sfrutta al massimo il nuovo 
JavaScript usato dai più grandi database incluso in Java6 



VISUAL BASIC 



GESTIONE DEL 
FORMATO XML 

Creiamo classi al volo partendo 
da un file di definizione 



ALGORITMI: 



Sfruttiamo il calcolo della mediana per creare 
strutture ordinate risparmiando tempo e cicli macchina 



DATABASE 



IMPORTA LE TABELLE 
DA UN DB ALL'ALTRO 

Creiamo script personalizzati 
per importare ed esportare dati 
e strutture senza problemi 



TROVIAMO TUTTO CON 
LE REGULAR EXPRESSI0N 

Ricerche di stringhe superveloci 
grazie alla Regex 
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▼ NUOVE FRONTIERE 



Lo ha detto Bill Gates: "non ci sono limiti allo sviluppo 
dell'informatica". Non arriveremo mai al punto di stal- 
lo della scienza. D'altra parte a dar ragione a Gates è 
la storia. Ciò che qualche anno fa sembrava pura fan- 
tascienza oggi è normalità. Così esistono dei mercati che 
oggi sembrano sempre sul punto di esplodere per poi 
assumere una posizione più defilata. Parliamo ad esem- 
pio del mercato dei device portatili. Sono ormai anni 
che dipingiamo questo settore come strategico. E so- 
no ormai anni che tuttavia ci ritroviamo a sviluppare 
per il desktop. Allo stesso modo Internet è da sempre 
definita come strategica, ma alla luce dei fatti alla fine 
il grosso dello sviluppo sta ancora sul mercato Desktop. 
Eppure questi settori sottilmente si sono insinuati nel- 
la nostra vita quotidiana, talmente tanto da non po- 
ter più rappresentare un mercato in via di sviluppo. 
Internet è l'elettrodomestico di questo secolo, ha la 
stessa diffusione di un televisore o di una lavatrice. Le 



applicazioni che girano su Internet sono ormai alla 
portata di tutti. Lo stesso identico concetto è applica- 
bile ai palmari e ai cellulari. È dunque il momento di so- 
gnare ancora. Di pensare ad applicazioni che oggi gior- 
no non sono alla portata di nessuno. Che sfruttino to- 
talmente l'utopia di una banda ultralarga, che faccia- 
no largo uso dell'intelligenza artificiale, che approcci- 
no mercati come la robotica e l'embedded. Dobbia- 
mo sganciarci dal concetto che il mercato emergente 
è il mobile o internet e cominciare a pensare che sia- 
mo noi programmatori a fare il mercato. Progettate 
buone applicazioni, innovative, tenetevi aggiornati e si- 
curamente i vostri sforzi verranno premiati. Troppi 
programmatori sono rimasti ancora legati a vecchie 
versioni dei linguaggi, a database ormai superati, a tec- 
niche in disuso. È ora di aggiornarsi, di entrare in una 
logica molto più dinamica, dove chi si adagia sulle pro- 
prie conoscenze è perduto. 



c? — z? — 

LI CD LI WEB 




All'inizio di ogni articolo, troverete un simbolo 
che indicherà la presenza di codice e/o software 
allegato, che saranno presenti sia sul CD (nella 
posizione di sempre \soft\codice\ e \soft\tools\) 
sia sul Web, all'indirizzo 
http://cdrom.ioprogrammo.it. 



FILE SHARING 

crea il tuo mulo da battaglia 

Svelato il codice di eMule! 
ti spieghiamo cosa si nasconde 
dietro al software più usato 
in Internet 



ARCHITETTURA La rete edonkey 
e il formato dei messaggi TPC/IP ,»', 

CONNESSIONE II codice 

per effettuare il login con i server 

RICERCA I comandi per scovare 
musica, film, software e tutto il resto 

DOWniLOAD/UPLOAD 

Scarica il file, salvali su disco 
e condividili con gli altri 

pag. 16 
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METTI WINDOWS 
SICUREZZA 




Ti spieghiamo come usare il Security Configuration Manager per trovare 
i buchi nella tua installazione e risolverli 

pag. 53 



IOPROGRAMMO WEB 



Dojo e Javascipt e tutto è semplice 
pag. 26 

Impariamo ad usare uno dei frameworke- 
mergenti per Ajax. Architettura a compo- 
nenti e gestione degli eventi. Al termine 
dell'articolo saremo in grado di program- 
mare alcune form molto speciali, vediamo 
come... 

Effetti grafici al volo per il Web 
pag. 30 

Impareremo come cambiare dinamicamente 
lo sfondo delle nostre pagine. Inoltre faremo 
in modo di utilizzare un effetto gradiente e 
diminuire il peso delle immagini sfruttando in 
modo particolare i fogli di stile 

Sviluppa per il Web con Yui. . pag. 36 

Impariamo a lavorare con il framework utiliz- 
zato da Yahoo per sviluppare applicativi sul 
Web dotati di una certa complessità, al ter- 
mine dell'articolo avremo gettato le basi per 
gestire un calendario perpetuo 

Un editor HTML nelle tue pagine 
pag. 40 

In questo articolo impareremo come rea- 
lizzare delle form molto particolari attra- 
verso la quali è possibile inserire in un 
database testi formattati in pieno stile 
Word processor. Faremo tutto questo solo 
usando Javascript 

Alla scoperta degli interceptor 
pag. 48 

Alla nostra applicazione è giunta una 
richiesta, possiamo gestirla facilmente con 
una action, ma come fare se volessimo 
"manipolarla" prima che essa sia gestita? 
La risposta è contenuta in questo articolo 



Alla scoperta dello strumento pensato da 
Microsoft per creare e distribuire il siste- 
ma operativo Windows Vista personaliz- 
zandolo con le impostazioni e il software 
più adatto per le proprie esigenze 

Applicazioni pratiche di XAML 
pag. 64 

XAMI è le novità del momento e molto se 
ne sta parlando ma cosa posssiamo real- 
mente fare con guesta nuova tecnologia? 
Vediamolo con un esempio concreto. 
Impareremo come sfruttare il drag & drop 

Disegnamo un form con WPF 
pag. 72 

Ridefinire un form con .Net non è cosa 
impossibile ma tutt'altro che banale e 
non sempre con risultati entusiasmanti. 
Oggi, grazie agli oggetti messi a dispo- 
sizione dal nuovo engine grafico WPF, 
tutto è semplificato 



DATABASE 



Un mifgratore di dati universale 
pag. 102 

Vi è mai capitato di implementare il vostro 
programma su un sistema di prova e doverlo 
poi implementare in un sistema in produzio- 
ne? La migrazione della struttura dati 
potrebbe non essere cosi semplice. Ecco un 
piccolo aiuto... 



Apache derby: il database 
tascabile pag- 86 

Una panoramica sul database relazionale 
scritto interamente in Java e recente- 
mente integrato da Sun Microsystems 
nell'ultima versione del JDK. Molto 
comodo per le sue ridotte dimensioni 



SISTEMA 



Il C++ incontra le Regular Expression 
pag. 90 

Non si può seriamente parlare di text pro- 
cessing, senza trattare anche le espressioni 
regolari. É vero che il C++ non supporta il 
regex? E quali sono le librerie che permet- 
tono di superare il problema? 



TEPRIMA 



Eclipse + Bordland = Jbuilder 2007 
pag. 105 

Borland ha deciso di adottare Eclipse 
come base per lo sviluppo dei nuovi IDE 
per Java, attorno ci ha costruito un'infra- 
stuttura di tutto rispetto aggiungendo 
decine di plugin. Ecco i dettagli... 



RUBRICHE 



SICUREZZA 



La sicurezza di Windows XP 
pag. 53 

Gli hacker sono in agguato pronti a sfrut- 
tare qualsiasi vulnerabilità di Windows 
XP e delle sue applicazioni: ecco perché è 
di fondamentale importanza conoscere il 
sistema di protezione che Microsoft rende 
disponibile 



SISTEMA 



Creiamo un vista personalizzato 

pag- 
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Gli allegati di ioProgrammo 

pag. 10 

// software in allegato alla rivista 

Il libro di ioProgrammo 

pag. 8 

// contenuto del libro in allegato 
alla rivista 

News pag. 14 

Le più importanti novità del 
mondo della programmazione 

Tips & Tricks pag. 78 

Una raccolta di trucchi da tenere a 
portata di... mouse 

Software pag. 107 

/ contenuti del CD allegato ad 
ioProgrammo. 



SOLUZIONE 



Calcolo della mediana 
pag. 111 

Find è un algoritmo per il calcolo della 
mediana. Si tratta della base teorica del 
conosciuto Quik Sort, non sempre usato 
per il suo scopo, appunto calcolare in 
modo efficiente in valore medio 



QUALCHE CONSIGLIO UTILE 

I nostri articoli si sforzano di essere 
comprensibili a tutti coloro che ci 
seguono. Nel caso in cui abbiate 
difficoltà nel comprendere 
esattamente il senso di una 
spiegazione tecnica, è utile aprire il 
codice allegato all'articolo e seguire 
passo passo quanto viene spiegato 
tenendo d'occhio l'intero progetto. 
Spesso per questioni di spazio non 
possiamo inserire il codice nella sua 
interezza nel corpo dell'articolo. Ci 
limitiamo a inserire le parti necessarie 
alla stretta comprensione della tecnica. 
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I contenuti del libro 



Programmare con .NET 3.0 



La novità più rilevante dell'anno in fatto di sistemi 
operativi è rappresentata probabilmente dall'arrivo di 
Windows Vista. Il nuovo OS di Microsoft sta rapidamente 
soppiantando Windows XP. Per noi progframmatori è tempo 
di aggiornare le nostre applicazioni e il miglor modo per farlo 
è quello di migrarle alla versione 3 del .NET framework. 
I vantaggi sono tanti e immediati. Prima di tutto una più 
moderna gestione del sistema grafico che si avvantaggia 
adesso di una struttura vettoriale, più internamente la 
possibilità di gestire con un unico strumento tutto il 
sottosistema di comunicazione. Infine non meno importante 
l'introduzione alla gestione dei flussi di lavoro. Il nuovo .NET 
pur essendo progettato per lavorare in coninuità con il 
precedente rappresenta senza dubbio un'opportunità da non 
perdere per rimanere al passo con i tempi. Ed è proprio in 
quest'ottica che si pone questo HandBook, ovvero come una 
guida rapida alla migrazione delle vostre applicazioni 



LA GUIDA PASSO PASSO PER IMPARARE 
RAPIDAMENTE A SVILUPPARE CON IL 
NUOVO FRAMEWORK DI MICROSOFT 

• Introduzione a .Net Framework 3.0 

• Windows Presentation Foundation 

• Windows Communication Foundation 

• Windows Workflow Foundation 
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Online con Tiscali Easy 

Numero unico per tutta l'Italia e nessuna registrazione. Il modo 
più semplice e veloce per entrare in Internet risparmiando 



Sei spesso lontano da casa e hai necessità di 
collegarti a Internet ovunque ti trovi? 
Desideri salvaguardare la tua privacy navigan- 
do in modo anonimo? Non hai voglia di perde- 
re tempo in lunghe registrazioni per creare un 
nuovo account? Niente paura, Tiscali ha pensa- 
to anche a te! Con Tiscali Easy arriva un siste- 
ma tutto nuovo di collegarsi a Internet. Non 
sarà più necessario creare un nuovo account e 
fornire i propri dati personali, potrai navigare 
collegandoti con un unico numero di telefono 
(7023456789) da tutta Italia e soprattutto utiliz- 
zando i dati di accesso forniti direttamente da 
Tiscali (UserID e Password presenti sulla sche- 
da), quindi non collegabili in alcun modo a te. 
Insomma, con Tiscali Easy, otterrai in un colpo 
solo riservatezza dei dati, risparmio del tempo 
necessario alla creazione di un abbonamento e 
tariffe vantaggiose. I costi di connessione sono 
simili a quelli di un classico abbonamento gra- 
tuito: 1,90 cent, per i primi 10 minuti e 1,72 
cent, per quelli successivi. Per risparmiare 
ulteriormente è possibile connettersi a 
Internet durante le ore serali o nei giorni festi- 



TISCALI EASY 

C'è un modo nuovo, semplice e veloce per entrare in Internet. Provalo subito! 




DI SCONTO 
AGGIUNTIVI 



30€. 

gassssnss 



Crea una nuova connessione inserendo il numero 
unico di accesso da tutta Italia 7023456789 

Avvia la connessione e digita i seguenti codici: 
UserID master2007 
Password tiscali 

Grazie per aver scelto Tiscali 
e buona navigazione! 

Costi di connessione disponibili su tiscali.it 
Servizio Assistenza dedicato 892130 



tiscali* 



vi al costo di 1,09 cent, per i primi dieci minuti 
e 0,98 cent, per quelli successivi. L'unico requi- 
sito richiesto per poter eseguire la connessione 
è un modem correttamente installato. Poiché 
si tratta di una normale connessione analogica 
è possibile utilizzare i tool di accesso remoto 
integrati in Windows 



IN RETE CON TISCALI 

Nessuna registrazione basta creare una nuova connessione e inserire 
i dati di accesso forniti da Tiscali 




File Modifica Visualizza Preferiti strumenti Avanzate ? 
^Indietro * _l ^p Cerca' [£> Cartelle [77!] - 
'■■' : " : ' .v **T Connessioni di rete 




sm. 



LAN a Internet ad alti, velocità 



H Connessior 



^ Installa una rete domes tica a | 

una piccola rete sSer : | Awia la Cre 
Igl Modifica Impostazioni Win dot* 



.q 



Vedere anche 

i_; RivCiluziiiTie dei problemi di 



Altre ri 



1 VM-areNen.orr.Mi 

W5 | VMnetS 
ti! Jt Connesso. 



Q NUOVA CONNESSIONE 
Portiamoci nel pannello di con- 
trollo, e selezioniamo l'icona connes- 
sioni di rete. In alto a sinistra sele- 
zioniamo "nuova connessione" e 
prepariamoci a seguire il wizard che 
comparirà 



informaci 



Password: 
i"'o!'i f !ì!iTia password: 

■.'v/.M: ■.';■.■::.« ■•■"":: ■:■■ •!.•■■.■■:■■:■■■■' ■ : ■ ■ . ■■ , .■ ■! :.| ! 

Imposta questa annessione nternei come predefinita 



; < Indietro jj Avanti > | [ Annulla ] 




HDATI DI ACCESSO 
Seguiamo il Wizard fino a 
quando non ci vengono chiesti i 
dati per l'autenticazione. E' suffi- 
ciente inserire quelli presenti nella 
card allegata a questo numero di 
ioProgrammo: master2007/tiscali 



H ACCESSO A INTERNET 
Connettersi è semplicissimo, 
troveremo una nuova icona all'in- 
terno del pannello di controllo alla 
voce connessioni. Bastano due click 
ed il gioco è fatto sarete connessi 
ovunque vi troviate 



http://www.ioprogrammo.it 



Giugno 2007/ 9 ». 



010 Presentaz CDRom 1 2-05-2007 15:38 Pagina 10 



Le versioni di ioProgrammo 




RIVISTA + CD-ROM 

in edicola 



DELPHI FOR PHP 

Il RAD per PHP targato Borland 



CodeGear 




PHP è uno dei linguaggi più utilizzati in 
programmazione, soprattutto per la sua 
vocazione verso il web. Le nuove versioni 
avevano risolto qualche problema legato 
alla mancanza di un forte orientamento 
alla programmazione ad oggetti, e dalla 
versione 5 in poi PHP è diventato davvero 
un linguaggio completo e professionale. 
Mancava un IDE RAD a PHP. A colmare 
questa lacuna ci ha pensato Borland con un prodotto il cui 
nome Delphi per PHP la dice lunga sulle caratteristiche 
dell'IDE. Sostanzialmente Delphi per PHP unisce ad un edito- 
re eccezionale un fortissimo orientamento visuale e ad even- 
ti che consente di programmare interfacce sofisticate 
mediante semplice trascinamento dei componenti su una 
form e conseguente programmazione degli eventi ad essi 
associati. Si tratta di un modo nuovo di programmare appli- 
cazioni PHP che potenzialmente aumenta moltissimo la pro- 
duttività di ogni programmatore. Si tratta ora di cambiare 
radicalmente il proprio modo di sviluppare per adattarsi alla 
logica contenuta nel framework sottostante l'IDE. 
Directory :/Delphi4php/d4php trial.exe 



Prodotti del mese 



Struts 2.0.1 

// framework MVC per Java 

II pattern MVC è probabilmente il 
più usato da tutti gli sviluppatori 
in ogni linguaggio. Questo fra- 
mework è il leader per quanto 
riguarda lo sviluppo di applica- 
zioni Java secondo il pattern 
MVC. Molto comodo, stabile e 
affidabile, rappresenta la base di 
partenza per applicazioni che 
devono essere facilmente manu- 
tenibili. Uno standard da usare 
se progettate applicazioni di 
dimensioni generose, ma anche 
quando si sviluppano web appli- 
cation professionali. 
L'impatto iniziale con il fra- 
mework potrebbe non essere dei 
più semplici a causa della com- 
plessità dello strumento. Ma 
superato il gradino iniziale e 
compresa la logica delle action 
tutto diventa estremamente 
semplice e conseguenziale. Ne 
parliamo approfonditamente in 
questo numero di ioProgrammo 
[pag.107] 



Struts 


^ ,_,_ T-nr-Ti 


MM 


.si-"- 






D • " '-'--'■ *-"-"' "-™_jn_ 



Java SE 
Development Kit 6 

// compilatore indispensabile 
per programmare in JAVA 

Se avete intenzione di iniziare a 
programmare in Java oppure 
siete già dei programmatori 
esperti avete bisogno sicura- 
mente del compilatore e delle 
librerie Java indispensabili. 
Sotto il nome di Java SE 
Development Kit vanno appunto 
tutti gli strumenti e le librerie 
nonché le utility necessarie per 
programmare in JAVA. L'attuale 
versione è la 6.0, ovvero la nuo- 
vissima release densa di innova- 
zioni e molto più legata al desk- 
top di quanto non fossero tutte 
le precedenti. 

Java è un linguaggio estrema- 
mente versatile la cui forza risie- 
de nell'estrema eleganza della 
sua programmazione ad oggetti 
e la capacità di generare appica- 
zioni più o meno per tutte le 
piattaforme oggi in commercio 
[pag.108] 




PHP 5.2.1 

// linguaggio di scripting più 
amato del web 

Sono tre le colonne portanti di Inter- 
net: PHP, APACHE e MySQL. Certo la 
concorrenza è forte. Asp.NET e SQL Ser- 
ver avanzano con celerità, ma a tutt'og- 
gi non si può affermare che i siti svi- 
luppati in PHP costituiscano la stragran- 
de maggioranza di Internet. Quali so- 
no le ragioni del successo di cotanto 
linguaggio? Prima di tutto la completez- 
za. PHP ha di base tutto quello che ser- 
ve ad un buon programmatore, rara- 
mente è necessario ricorrere a librerie 
esterne, e quando è proprio indispen- 
sabile farlo esistono comunque una se- 
rie di repository che rendono tutto im- 
mediatamente disponibile ed in forma 
gratuita. Il secondo punto di forza del 
linguaggio sta nella sua capacità di po- 
ter essere utilizzato sia in modo pro- 
cedurale che nella sua forma ad ogget- 
ti certamente più potente e completa. 
Esiste un terzo di punta di forza essen- 
ziale che è quello riguardante la curva 
di apprendimento. 
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PHP 5.2.1 Release Annoi 

The PHP development team would 
enhancement of the 5.X branch, a 



Drupal 5.1 



// costruttore di Blog 

Drupal è prima di tutto un siste- 
ma CMS, consente cioè la pubbli- 
cazione dei contenuti in modo 
semplificato, di modo che anche 
gli utenti meno smaliziati possa- 
no inserire dei contenuti su 
Internet pur non avendo cono- 
scenze di programmazione o di 
html, ma Drupal è anche molto di 
più. Utilizzando Drupal ognuno 
degli utenti iscritti al sito diviene 
proprietario di un blog e con 
pochi accorgimenti potrete fare 
in modo che ciascuno di questi 
blog goda di una vita propria 
indipendente dal sito principale, 
oppure se lo desiderate potete 
far comunicare i vari blog in 
modo da creare una vera com- 
munity di bloggers. Qualche 
parola va spesa anche sull'archi- 
tettura a plugin. Sviluppare un 
plugin per drupal è veramene un 
gioco da ragazzi grazie al fra- 
mework che ne è la base 
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GLI ALLEGATI DI IO PROGRAMMO 

Questo mese tre Webcast per imparare a sviluppare 
applicazioni a prova di hacker su ambiente Windows 



La validazione dell'input 

La validazione dell'input consiste nel verificare che qualsiasi parametro in ingres- 
so nella applicazione sia conforme a quanto ci si aspetta. Per esempio un campo 
che accetti un indirizzo di posta elettronica deve scartare stringhe che non abbia- 
no il formato desiderato. Oltre a migliorare la qualità dei dati, la validazione evita 
pericolosi attacchi come SQL Injection o Cross-Site Scripting che possono deva- 
stare il database o mettere a serio rischio la riservatezza dei dati. Nel corso del 
webcast vedremo come funzionano questi attacchi e come difenderci sia in 
applicazioni web che Windows. 

Perché sviluppare pensando da subito 
alla sicurezza 

Purtroppo ancora troppo spesso si guarda alla sicurezza come un problema 
secondario. In questo primo webcast sulla sicurezza vogliamo analizzare perché 
questo concetto sia radicalmente sbagliato e quanto sia importante pensare alla 
sicurezza fin dal suo progetto e prima di cominciare a scrivere codice. 

Autenticazione ad autorizzazione 

Autenticazione ed autorizzazione sono due processi fondamentali in sicurezza. Il 
primo risponde alla domanda "chi sei" mentre il secondo alla domanda "cosa 
puoi fare". La piena comprensione di questi meccanismi permette di risolvere 
problematiche molto comuni nello sviluppo di applicazioni. Per esempio i mec- 
canismi di impersonation e delegation e i problemi e le vulnerabilità che posso- 
no derivare da un uso incorretto. 



PERCORSI webcast 

Progettare una architettura sicu- 
ra parte 1 • L'evoluzione della 
sicurezza nel Framework: la Code 
Access Security • ASP.NET 2.0 
AJAX: ASP.NET AJAX Control 
Toolkit «10 miti da sfatare su 
Windows Vista e Office System 
2007 • Microsoft Solutions 
Framework un anno dopo: lezioni 
apprese, cosa ha funzionato e 
cosa si può migliorare nell'ado- 
zione di questa metodologia • 
ASP.NET 2.0 AJAX: Server Controls 

Proteggere le comunicazioni in 
applicazioni distribuite • 
Tecniche di Search Engine 
Optimization con ASP.NET 2.0 • 
Autenticazione ed autorizzazione 

SQL Server Advanced Express 

Visita 

http://www.microsoft.com/italy/ 

msdn/risorsemsdn/security/ 

default.mspx 



FAQ 



Cosa sono i Webcast MSDN? 

MSDN propone agli sviluppatori una serie di eventi gratuiti 
online e interattivi che approfondiscono le principali temati- 
che relative allo sviluppo di applicazioni su tecnologia 
Microsoft. Questa serie di "corsi" sono noti con il nome di 
Webcast MSDN 

Come è composto tipicamente un Webcast? 

Normalmente vengono illustrate una serie di Slide commenta- 
te da un relatore. A supporto di queste presentazioni vengono 
inserite delle Demo in presa diretta che mostrano dal vivo 
come usare gli strumenti oggetto del Webcast 

Come mai trovo riferimenti a chat o a strumenti 
che non ho disponibili nei Webcast allegati alla 
rivista? 

La natura dei Webcast è quella di essere seguiti OnLine in 
tempo reale. Durante queste presentazioni in diretta vengono 
utilizzati strumenti molto simili a quelli della formazione a 
distanza. In questa ottica è possibile porre domande in presa 
diretta al relatore oppure partecipare a sondaggi etc. I 
Webcast riprodotti nel CD di ioProgrammo, pur non perdendo 



nessun contenuto informativo, per la natura asincrona del sup- 
porto non possono godere dell'interazione diretta con il rela- 
tore. 

Come mai trovo i Webcast su ioProgrammo 

Come sempre ioProgrammo cerca di fornire un servizio ai pro- 
grammatori italiani. Abbiamo pensato che poter usufruire dei 
Webcast MSDN direttamente da CD rappresentasse un ottimo 
modo di formarsi comodamente a casa e nei tempi desiderati. 
Lo scopo tanto di ioProgrammo, quanto di Microsoft è infatti 
quello di supportare la comunità dei programmatori italiani 
con tutti gli strumenti possibili. 

Su ioProgrammo troverò tutti Webcast 
di Microsoft? 

Ne troverai sicuramente una buona parte, tuttavia per loro 
natura i webcast di Microsoft vengono diffusi anche OnLine e 
possono essere seguiti previa iscrizione. L'indirizzo per saperne 
di più è: www.microsoft.it/msdn/webcast. segnalo nei tuoi 
bookmark. Non puoi mancare. 

L'iniziativa sarà ripetuta sui prossimi numeri? 

Sicuramente si. 
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News I nessun L|M|TE ALL ° sviluppo 



LAS VEGAS 
SBARCA IM ITALIA 

gni anno si tiene a Las Vegas un 
evento denominato "Mix". Si trat- 
ta dell'evento più importante dell'an- 
no per la presentazione delle nuove 
tecnologie targate Microsoft. E' du- 
rante questo evento che i maggiori 
esperti in informatica del mondo illu- 
strano le tecnologie e le linee guida 
per il futuro. Quest'anno si terrà in Ita- 
lia un evento gemello: il remix 2007. 
Saranno proprio gli stessi esperti del 
Mix a venire a presentare in Italia le 
nuove tecnologie. L'evento si terrà il 
29 e il 30 Maggio a Milano e si avvarrà 
del servizio di traduzione simultanea. 
Il cuore dell'evento sarà dedicato allo 
sviluppo di applicazioni per il Web in- 
tesi sia come Designer che come pro- 
grammatori. Come sempre sarà possi- 
bile fra i vari percorsi. Per chi desiderasse 
maggiori informazioni il link di riferi- 
mento è 
http://www.microsoft.it/msdn/remix. 



DOMINI IT 
PIÙ FACILI? 

ttualmente l'Italia è uno dei po- 
chi paesi al mondo in cui la pro- 
cedura di registrazione del dominio 
comporta l'invio di un fax e la gestio- 
ne semimanuale dei dati in esso con- 
tenuti e necessari per l'approvazione. 
Questa procedura decisamente arcai- 
ca è diventata ormai un collo di botti- 
glia importante a causa del crescente nu- 
mero di richieste di registrazione. Tan- 
to che si registrano diverse petizioni a 
favore di un cambio radicale nella ge- 
stione delle registrazioni da parte del 
NIC. 

Così l'ente italiano per la registrazio- 
ne dei domini si è vista costretta a ri- 
spondere dichiarando che si sta effet- 
tuando una transizione importante da 
una gestione asincrona ad una gestio- 
ne sincrona e si sta tendando anche di 
aumentare il personale dedicato alla 
registrazione dei domini. Si tratta solo 
di pazientare e anche l'Italia riuscirà, 
forse, a registrare un dominio in 15 mi- 
nuti come succede per i .coni e gli al- 
tri invece che in una settimana o più 
come avviene adesso 



Adirlo è Bill Gates in persona 
durante il recente Intel 
Developer Forum di Pechino rispon- 
dendo a chi gli chiedeva, preoccupato, 
se ad un certo punto lo sviluppo tec- 
nologico potesse incontrare un punto 
di rallentamento. Nessun rallenta- 
mento secondo Bill Gates, non esiste e 
non esisterà mai un momento in cui la 
tecnologia raggiungerà un suo limite 
ed in cui lo sviluppo subirà un rallen- 
tamento. Ogni limite verrà sempre 
costantemente abbattuto. Il proprie- 
tario di Microsoft immagina un 
mondo fatto di dispositivi mobili lar- 
gamente interconessi, di una rete 
wireless che contribuirà ad abbattere 
gli attuali limiti della diffusione via 
cavo, della Televisione sempre più pre- 
sente nella trasmissione via TCP/IP. Si 
tratta di un futuro non così lontano e 
quel che più conta si tratta solo di una 
pietra superabile alla quale si sostitui- 
ranno altri traguardi. Peccato che ad 
interrompere i sogni di Gates sia inter- 



venuto un contestatore che con tanto 
di bandiera inneggiante al software 
OpenSource è salito sul palco a testi- 
moniare la presenza del Free Software 
nel mondo dell'informatica. Quasi 
come a voler dire: il futuro è inarre- 
stabile, l'informatica anche e 
l'OpenSource vuole contribuire alme- 
no allo stesso modo in cui contribuisce 
Microsoft. Ovviamente il contestatore 
è stato ricondotto all'ordine dalle 
forze di polizia presenti al congresso 




FLEX DIVENTA 
OPENSOURCE 



Adobe ha recente- 
mente annunciato 
di voler rilasciare l'inte- 
ra piattaforma di svilup- 
po di applicazioni dina- 
miche denominata Flex 
con il modello Open- 
Source. Flex è una piat- 
taforma che ha incontra- 
to una larga approvazio- 
ne da parte dei program- 
matori. Sostanzialmente 
consente di sviluppare 
intere applicazioni flash 
con una modalità com- 
pilativa molto diversa a 
quella a cui sono abitua- 
ti i programmatori Flash. 
Con la stessa modalità si 
possono ottenere facil- 



mente applicazioni che 
si connettono a databa- 
se o fanno un largo uso 
di XML. Si tratta insom- 
ma di un modello che ha 
come risultato finale pur 
sempre un file SWF ma 
che parte da una modalità 
molto simile a quella uti- 



lizzata dai programma- 
tori per scrivere il codice 
piuttosto che ad un am- 
biente grafico. 
Flex sarà lisciata con mo- 
dello OpenSource su tut- 
te e tre le piattaforme più 
importanti: Linux, Win- 
dows, Mac OS 
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DISPONIBILE LA PRIMA 
BETA DI LONGHORN 



Microsoft ha finalmente rilasciato una 
versione beta di quello che dovrà 
essere il suo sistema operativo Server del 
futuro. Longhorn si basa largamente sul- 
l'esperienza di vista ed aggiunge parecchi 
strumenti innovativi che dovrebbero au- 
mentare stabilità e sicurezza del proprio 
sistema server. Le innovazioni più inte- 
ressanti oltre a quelle già presente in Win- 
dows Vista riguardano la rete e la sicurez- 
za. In particolare sarà massiccia la pre- 
senza del NAP ovvero del servizio alle cui 
policy tutti i partecipanti al network do- 
vranno adeguarsi per ottenere l'accesso 
alla rete. Il NAP in realtà è già presente in 
Vista ma in Longhorn assumerà un aspet- 
to ancora più centrale. Per quanto riguar- 
da il ruolo di controller, il vecchio Backup 
Domain controller sarà affiancato dal nuo- 
vo read-only domain controller che potrà 
contenere una copia in sola lettura del da- 
tabase active directory in modo da salva- 
guardarne la sicurezza anche in caso di 
guasti hardware. Per gli amministratori di 
grandi reti aziendali da segnalare l'ado- 



zione di WIP come formato per la distri- 
buzione delle immagini di installazione 
di Windows Longhorn. Proprio di WIP par- 
liamo abbondantemente con un articolo 
minuzioso in questo stesso numero di io- 
Programmo. La comunità dei sistemisti 
ha mostrato già un'interesse molto eleva- 
to per il nuovo sistema tanto che sono già 
quasi 10.000 gli iscritti al programma Be- 



ta. C'è da dire che Windows in versione 
Server è il prodotto più usato per quanto 
riguarda l'attività di Controller di Domi- 
nio e che sta scalando posizioni anche ri- 
spetto ai servizi di directory di Novell. Di- 
versa è la situazione in ambiente Web la 
dove US pur guadagnando terreno non 
riesce ad avere la stessa distribuzione ca- 
pillare di Apache 
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GOOGLE DA URIA MARIO A MYSQL 



Sembra che il gigante dei 
motori di ricerca per le 
proprie applicazioni abbia 
fatto uso molto spesso del no- 
to serve di database MySQL. 



Tuttavia come è noto Google 
non si accontenta ma dispo- 
ne di una capacità tecnica di 
assoluto rilievo, per cui ha svi- 
luppato delle patch per per- 



sonalizzare le proprie instal- 
lazioni di MySQL. E' recente 
l'annuncio della disponibi- 
lità sotto licenza GPL di tali 
patch. In particolare si trat- 




terebbe di alcune modifiche 
che coinvolgono il meccani- 
smo di clustering e replica dei 
database. In ogni caso le pat- 
ch sono pubblicamente di- 
sponibili all'indirizzo 
http://code.google.eom/p/goo 
gle-mysql-tools/. MySQL Ab 
sta prendendo in considera- 
zione l'ipotesi di inserire que- 
ste patch nelle proprie ver- 
sioni ufficiali, d'altra parte si 
sa che Google è un partner 
decisamente affidabile. Da 
un punto di vista prettamen- 
te filosofico è interessante an- 
notare come la personalizza- 
zione di strumenti Open- 
Source possa poi concreta- 
mente applicarsi anche a realtà 
dalla dimensioni decisamente 
generose 
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VIAGGIO ALL'INTERNO 
DEL CUORE DEL MULO 

IL PEER-TO-PEER È UNO DEI FENOMENI DI MASSA DEGLI ULTIMI ANNI. LA TECNOLOGIA CHE SI 
NASCONDE DIETRO AL FILE SHARING È RAFFINATA QUANTO SEMPLICE. IN QUESTO ARTICOLO 
ANALIZZIAMO I SORGENTI DI EMULE PER CAPIRE COME POSSIAMO MODIFICARLO PER NOI... 
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e Mule è una delle applicazioni di file sharing più 
popolari e utilizzate al mondo. La storia di eMu- 
le inizia nel maggio 2002, quando Hendrik Breitk- 
reuz (conosciuto come Merkur, vedi lo splash screen 
di Emule) , insoddisfatto del client originale per la re- 
te eDonkey2000, inizia a lavorare al progetto. 
Alla versione attuale, la 0.47, eMule consente di con- 
nettersi sia alla rete eDonkey, che alla rete Kad. Fra le 
caratteristiche che lo hanno portato ad essere uno dei 
client P2P maggiormente utilizzati, vi sono lo scam- 
bio diretto fra le sorgenti localizzate nei computer 
client, recupero dei download interrotti o corrotti, l'u- 
tilizzo di un sistema a crediti che incoraggia la condi- 
visione e l'upload, la trasmissione in formato com- 
presso zlib, per risparmiare larghezza di banda. 
eMule è stato sviluppato, e continua ad esserlo, in Vi- 
sual C++ (sembra strano, un'applicazione open sour- 
ce, programmata con un IDE Microsoft!), viene rilascia- 
to sotto licenza GPL (GNU General Public License), 
ed è disponibile, tramite progetti paralleli da esso de- 
rivati, anche sotto altre piattaforme, per esempio esi- 
ste il client xMule per Linux. Sempre più lunga anche 
la lista di altri progetti (detti Mod) che apportano mo- 
difiche all'originale: eMule Extreme, eMule plus, aMu- 
le. A proposito, perché il nome eMule? In inglese 
Donkey significa "asino", quindi Merkur scelse un no- 
me simile: Mule, cioè "mulo". 



ARCHITETTURA 
DI EMULE 

Una rete eMule è costituita ormai da centinaia di ma- 
chine che agiscono da server eMule e milioni di PC 
nelle case degli utenti che svolgono il ruolo di client eMu- 
le. I client devono come primo passo connettersi ad un 
server, per ottenere accesso alla rete eMule. La con- 
nessione al server rimarrà attiva per tutto il tempo in 
cui il client resterà connesso alla rete eMule. 
Un server eMule esegue compiti di indicizzazione dei 
contenuti e non comunica mai con altri server eMu- 
le. Ogni client invece possiede una lista di server eMu- 
le, oppure può essere aggiornato con un nuovo elen- 



co, ottenibile sia sui siti specializzati, oppure richieden- 
dolo mediante apposito comando ad un server a cui 
esso possa connettersi. 

Ogni client inoltre possiede un proprio elenco di file, 
che mette a disposizione della comunità eMule, vale 
a dire la lista dei file condivisi. 
La connessione di un client ad un server eMule av- 
viene utilizzando il protocollo TCP tramite esso si ot- 
tiene l'elenco dei file disponibili e dei client sui quali 
questi sono presenti. Dopo aver effettuato l'accesso, 
mediante altre centinaia di connessioni TCP un client 
comunica con i suoi pari, per effettuare l'upload o il down- 
load di file. 

Tale processo è regolato mediante code di accesso ad 
ogni determinato file. Ogni coda è formata dai client 
che hanno richiesto lo stesso file, e che mano a mano 
che uno di essi completa il download permette l'a- 
vanzamento di un altro client. Per migliorare le presta- 
zioni, e velocizzare il download, ogni client non effet- 
tua il download di un intero file da un singolo altro 
client. Ogni file è invece suddiviso in parti, ognuna 
delle quali può essere richiesta e scaricata da un client 
diverso. In tal modo possono essere sfruttate centi- 
naia di sorgenti differenti e contemporaneamente il client 
può fornire le parti che ha già scaricato mettendole a 
disposizione di altri client. 

Il protocollo eMule prevede inoltre un sistema di cre- 
diti, che avvantaggia i client che mettono a disposi- 
zione un maggiore numero di file, incoraggiando la 
condivisione. 

Ogni server eMule mantiene un database, con le infor- 
mazioni relative ai client ed ai file condivisi, ma non 
memorizza alcun file, agendo solo da indicizzatore. 
La figura 1 rappresenta l'architettura di alto livello di 
una rete di server e client Emule per la condivisione di 
file. Un buon modo per capire il funzionamento di 
eMule è quello di scaricare il sorgente del client, ed 
eseguirlo in debug, seguendo passo passo lo scam- 
bio di messaggi. Naturalmente è necessario conosce- 
re il linguaggio C++ e possedere Visual C++. 
Nel seguito dell'articolo, implementeremo qualche 
spezzone di codice C#, per studiare il protocollo e ve- 
rificarne le funzioni. 
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eMule Server 





Fig. 1: Diagramma di una rete di server e client Emule 



AL SICURO. 
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IL FILE 

SERVER. MET 

L'elenco dei server uti- 
lizzati da eMule è con- 
tenuto in un file ser- 
ver.met, presente 
nella directory di 
avvio del programma. 
L'elenco può essere 
aggiornato sia fornen- 
do l'uri di un 
server.met presente in 
internet, oppure è pre- 
visto dal protocollo 
eMule un comando 
OP SERVERLIST (0x32) 
che permette di effet- 
tuare una richiesta al 
server eMule a cui un 
client è connesso per 
richiedere una lista dei 
server aggiornata. Nel 
codice allegato all'arti- 
colo è implementato 
sia tale comando, si 
veda la classe 
ServerListRequest, sia 
l'interpretazione del 
formato binario di un 
file met. 



FORMATO 
DEI MESSAGGI 

Ogni messaggio ha una intestazione lunga 6 byte, sud- 
divisi in tre parti. Il primo byte indica protocollo uti- 
lizzato, ed ha il valore 0xE3 per eDonkey, oppure 0xC5 
per il protocollo eMule. 

I successivi 4 byte indicano la lunghezza del messag- 
gio in byte, escluso l'header stesso. Quindi un mes- 
saggio formato solo dall'intestazione conterrà come 
size il valore zero. 

Infine, il terzo campo dell'intestazione, cioè l'ultimo 
byte, è l'identificatore univoco del messaggio stesso, 
un ID che indica il comando. 



protocol 
1 byte 


size 
4 bytes 


type 

1 byte 



Message Header di eMule 



Fig. 2: L'intestazione di un messaggio Emule 



Creiamo quindi una classe C# per rappresentare un'in- 
testazione di messaggio: 

public class MessageHeader 

{ 

public Protocol. ProtocolType protocolID; 
public uint packetSize; 
public byte Command; 



public MessageHeader(byte command) :base() 
{ 



protocolID 



Protocol . ProtocolType. eDonkey; 



Command = command; 



packetSize = 6; 



public void Serialize(BinaryWriter writer) 



{ 



writer. Write((byte)protocolID); 



writer. Write(packetSize); 



writer. Write(Command); 



} 



Per comodità possono essere aggiunti altri costrutto- 
ri, che per brevità non riportiamo qui. 
Il metodo Serialize invece ci servirà per scrivere l'in- 
testazione su uno stream da spedire in rete. 

Per appendere informazioni aggiuntive ai messaggi 
eMule, vengono utilizzate delle strutture chiamate 
Tags, e strutturate secondo una sequenza Tipo-Lun- 
ghezza-Valore (per questo vengono detti anche Tag 
TLV). 

Esistono diversi tag differenti, documentate nel pro- 
tocollo di eMule liberamente scaricabile dalla rete. 



Nel seguito dell'articolo ne mostreremo ed utilizze- 
remo qualcuno di essi. 

Ogni tag è formato da 4 campi, non tutti però vengo- 
no sempre inclusi nel corpo del messaggio: 



Tipo 


1 byte, indica il tipo del tag 


Nome 


può essere formato da una stringa di 
lunghezza variabile o da un 
intero di 1 byte; 


Valore 


può essere un intero di 4 byte, un 
numero floating di 4 byte, oppure 
una stringa di lunghezza variabile; 


Special 


è un intero di 1 byte, che identifica un 
tag speciale; 



Tag con valori interi sono detti Integer tags, analoga- 
mente si hanno String tags e Float tags. Il tipo di un 
String tag è 2, di un Integer tag è 3 e di un Float tag is 
4. Quando i tag vengono codificati per essere spediti 
in rete, viene seguito l'ordine seguente: prima il tipo, 
poi il nome ed infine il valore. 
I nomi dati ai tag non hanno un significato partico- 
lare per il protocollo, vengono solo assegnati per un più 
semplice ed immediate riferimento nella descrizio- 
ne dei messaggi. 

Per leggere un tag implementiamo quindi una clas- 
se TagReader, in questa maniera: 

public class TagReader 

1 

public byte type; 



public byte id; 



public string name; 



public string strVal; 



public uint numVal; 



public float floatVal; 



public TagReader(BinaryReader reader) 



{ 



ushort len; 



type = reader.ReadByte(); 



len = reader.ReadUIntl6(); 



if (len == 1) 



id = reader.ReadByte(); 



else 



if (len > 0) name = new 

string( reader. ReadChars(len)); 



switch(type) 



{ 



case 2: 



len = reader.ReadUIntl6(); 



byte[] buf; 



buf = reader.ReadBytes(len); 



strVal 



Encoding. Default. GetString(buf); 



break; 
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case 3: 


numVal = reader.ReadUInt32(); 


break; 


case 4: 


floatVal = reader.ReadSingle(); 


break; 


} 


} 


} 


} 



Analogamente si può implementare la classe per scri- 
vere un tag, che non riportiamo qui per brevità ma 
che è possibile analizzare nel codice in allegato. 



COMANDI ED OPCODE 

Ogni comando eMule è identificato da uno specifico 
codice esadecimale, detto OpCode. Ogni comando 
inoltre prevede una serie di parametri da specificare. 
La connessione avviene inviando un comando con 
OpCode OP_LOGINREQUEST, pari al valore 0x0 1 . 
Per evitare di specificare ogni OpCode di volta in vol- 
ta, e rendere più facilmente gestibili i comandi im- 
plementeremo delle enumerazioni. Per esempio per 
i comandi da inviare al server una enumerazione Ser- 



verCommand con relativi opcode: 



public enum ServerCommand : byte 



{ 



LoginRequest = 0x01, 



ServerMessage = 0x38, 




IDChange = 0x40, 



GetServerList = 0x14, 



OfferFiles = 0x15, 



SearchRequest = 0x16, 



ServerList = 0x32, 



SearchResult = 0x33, 



GetSources = 0x19, 



QueryMoreResuIts = 0x21, 



FoundSources = 0x42, 



CallBackRequest = OxlC, 



ServerState = 0x34, 



Serverldent = 0x41, 



CallBackRequested = 0x35, 



} 



Allo stesso modo si possono implementare enume- 
razioni per i comandi client, o per i valori dei campi di 
un tag. Per un server eMule per esempio si possono spe- 
cificare ed ottenere le seguenti informazioni: 

public enum ServerTag : byte 
{ 



AL SICURO. 




SmartPic* 



SmartPico è il dispositivo driverless che combina e fonde in un'unica chiave le caratteristiche di protezione per gli 
applicativi insite in SmartKey, insieme a quelle di praticità e trasporto dati tipiche di PicoDisk 4CD. 
Grazie a queste particolarità è possibile installare un applicativo su SmartPico ed eseguirlo direttamente dalla 
chiave senza dover installare nulla sul PC. La memoria è partizionabile in più dischi, uno dei quali può avere la 
funzionalità CD e quindi supportare l'autorun. 
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Name = 0x01, 



Description = OxOB, 



Ping = OxOC, 



Priority = OxOE, 



Fails = OxOD, 



DynlP = 0x85, 



LastPing = 0x86, 



MaxUsers = 0x87, 



CONNESSIONE 

AD UHI SERVER EMULE 

Per connettersi ad un server eMule è necessario in- 
viare l'apposito comando di Login, con opCode Lo- 
ginRequest. Innazitutto è però necessario stabilire 
una connessione TCE 

Per rappresentare una connessione al server creere- 
mo una classe ServerConnection, derivata da una ge- 
nerica Connection, che utilizzerà i classici socket per 
creare una comunicazione TCP ad un indirizzo IP su 
una data porta. 

La classe Connection possiede quindi, fra gli altri i se- 
guenti campi: 



public 


class Connection 






{ 




protected 


Socket m_ 


soc 


ket; 




protected 


IPEndPoint 


m_ 


_EPremote; 


} 



Al metodo CreateConnection si passeranno l'indiriz- 
zo IP e la porta verso cui effettuare la connessione: 

m_socket=new Socket(AddressFamily.InterNetwork, 
SocketType.Stream,ProtocolType.Tcp); 
m_socket.Blocking=false; 
IPAddress ip=new IPAddress(nlP); 
m_EPremote=new IPEndPoint(ip,port); 

Mentre il metodo Connect invierà una richiesta asin- 
crona di connessione, indicando il metodo OnConnec- 
ted come metodo che si occuperà di gestire la rispo- 
sta del server una volta ricevuta una risposta. 

public void Connect() 

{ 
try 

{ 

if (!m_socket.Connected) 
m_socket.BeginConnect(m_EPremote, 
new AsyncCallback(OnConnected),null); 

} 
catch 

{ 
OnConnectionFail((byte)Protocol.ConnectìonReason.C 

annotConnect); 



protected override void OnConnected(IAsyncResult 



ar) 



base.OnConnected(ar); 



if (m_socket.Connected) 



{ 



m_Server.LastConnection 

DateTime.Now.Ticks; 



m_Server.ResetFails(); 



m_Server.IsConnected = true; 



m_Server.SendLoginRequest(); 



m_Server.ConnectionReady(); 



} 



All'interno del metodo OnConnected viene innanzi- 
tutto impostato l'istante dell'avvenuta connessione, 
ed azzerati i tentativi falliti. 

Un'altra classe, Server, si occuperò di inviare e rice- 
vere i messaggi dai server eMule. In questo primo 
esempio il metodo SendLoginRequest invia il mes- 
saggio di Login suddetto, costruendo un oggetto Ser- 
verLoginRequest che si occupa di riempire e format- 
tare un buffer contenente la richiesta di login, e spe- 
dendo poi il messaggio mediante il metodo Send- 
Packet: 

public void SendLoginRequest() 

{ 

if (m_ServerConnection == nuli) 

return; 
MemoryStream buffer = new 

MemoryStreamQ; 
ServerLoginRequest hello = new 

ServerLoginRequest( buffer); 
m_ServerConnection.SendPacket(buffer); 



private void SendPacket(byte[] packet,int length) 

1 

if 
((!m_socket.Connected)| |(m_SendPacket! = null)) 

{ 

return; 

} 

m_SendPacket=packet; 

m_SendBytesPending = length; 

m_TotalSent=0; 

try 

{ 
m_socket.BeginSend(m_SendPacket,0,m_SendBytes 
Pending,SocketFlags.None,new 
AsyncCallback(m_OnSentPacket),null); 

} 
catch 
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{ 

OnConnectionFail((byte)Protocol.ConnectionReason.CI 

osedConnection); 
} 
} 

La classe ServerLoginRequest serve a formattare il 
messaggio di Login, costruendone l'intestazione, me- 
diante l'utilizzo degli appropriati Tag. Il messaggio di 
Login, come specificato nella documentazione del 
protocollo eMule, deve contenere innanzitutto un in- 
testazione e poi una serie di altre informazioni come 
l'id utente, versione del client, nome del client e così 
via. L'intestazione è costruita mediante la classe Mes- 
sageHeader al cui costruttore viene passato il valore Ser- 
verCommand.LoginRequest. 

public ServerLoginRequest(MemoryStream buffer) 

1 

MessageHeader header; 
BinaryWriter writer = new 

BinaryWriter(buffer); 
header = new 
MessageHeader((byte)Protocol.ServerCommand.Logi 

nRequest, writer); 
writer. Write(Preferences.UserHash); 
writer. Write(Preferences.ID); 
writer. Write(Preferences.TCPPort); 



uint nTags = 4; 



writer. Write(nTags); 



// user 



TagWriter((byte) Protocol. ClientParameter.Na me, 
Preferences.UserName, writer); 



// version 



TagWrìter((byte)Protocol.ClientParameter.Version, 
Protocol. EDONKEYVERSION, writer); 



// port 



TagWriter((byte)Protocol.ClientParameter.Port, 
(uint)Preferences.TCPPort, writer); 
new 
TagWriter((byte) Protocol. ClientParameter.EmuleVersio 

n, 
Protocol. EMULE_VERSION_COMPLEX, writer); 
header.packetSize = 
(uint)writer.BaseStream.Length - header.packetSize 

+ 1; 
writer. Seek(0, SeekOrigin.Begin); 



header.Serialize(writer); 



} 



La lunghezza del messaggio varia quindi in base alla 
configurazione dell'utente, per esempio dal suo nick- 
name. 




AL SICURO. 







PicoDisk 4CD è la chiave di memoria USB 2,0 Hi Speed dedicata alle software house che intendano rendere 
utilizzabili le proprie applicazioni direttamente da una chiave USB. 

La memoria flash del dispositivo può infatti essere partizionata in 4 differenti tipologie di unità logiche più un'area 
nascosta, che verranno combinate dalla software house in base alle esigenze della propria applicazione, arrivando a 
supportare la coesistenza su un unico dispositivo di un massimo di 4 partizioni più l'eventuale hidden area. 
PicoDisk 4CD può essere un semplice Mass Storage opzionabilmente reso accessibile in sola lettura, un CD-ROM 
o entrambi, e può avere un'area di memoria completamente crittografata. 
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Al ricevimento di un messaggio di risposta, dopo aver 
letto e processati i byte del messaggio. 
A connessione avvenuta, il metodo Processmcoming- 
Packet verifica il comando specificato nell'intestazio- 
ne del messaggio, ed intraprende l'azione opportu- 
na. 

protected override void ProcessIncomingPacket(ref 

byte[] packet) 

1 

if (m_Server == nuli) return; 



try 



switch 
((Protocol. ServerCommand)m_Header.Command) 



{ 



Protocol. ServerCommand.ServerMessage: 



m_Server.SetMessage(packet); 



} 



break; 



case 
Protocol. ServerCom ma nd.SearchResult: 
m_Server.ProcessSearchResults(packet); 



break; 



case 

Protocol. ServerCommand.ServerState: 



m_Server.UpdateState(packet); 



break; 



break; 



case 

Protocol. ServerCommand.Serverldent: 
m_Server.ProcessDescription(packet); 
break; 
case 
Protocol. ServerCommand.ServerList: 
m_Server.ProcessServerList( packet); 
break; 
default: 
break; 



Protocol. ServerCommand.IDChange: 
uint m_ID; 
string LowHigh_ID = "low ID"; 



bool isHighID = false; 



} 



catch (Exception e) 



{ 



throw; 



BinaryReader reader = new 
BinaryReader(new MemoryStream(packet)); 



m_ID = reader.ReadUInt32(); 



if (reader.PeekChar() > 0) 



{ 



m_Server.TCPFIags = 

reader.ReadUInt32(); 



else 



m_Server.TCPFIags = 0; 



if (m_ID > 0) 



{ 



if (m_ID > 

Protocol. LowIDLimit) 



{ 



LowHighJD = "high ID" 



isHighID = true; 



else 



LowHighJD = "low ID" 



isHighID = false; 



} 



ServerManager.ActiveServer.UserID = m_ID; 
ServerManager.ActiveServer.IsHighID=isHighID; 



} 



else 



{ 



OnConnectionFail((byte)Protocol.ConnectionReason.N 

ullID); 



} 



Nel caso del messaggio di Login, verrà ricevuto come 
risposta un messaggio ServerMessage. Tale messaggio 
può avere lunghezza ed è spedito da un server in di- 
verse occasioni, non solo dopo una richiesta di login. 
Un singolo server- message può contenere diverse ri- 
ghe di testo separate da caratteri new line, ('\r',' \n' o 
entrambe). Messaggi che iniziano con il testo "server 
version", "warning", "error" e " [emDynlP: " hanno un 
significato per il client e possono essere trattati in ma- 
niera speciale. Gli altri messaggi possono semplice- 
mente essere mostrati all'utente. 
Nello switch del metodo ProcessIncomingPacket, esi- 
ste un case apposito per elaborare un ServerMessa- 
ge, all'interno del quale viene invocato il metodo Set- 
Message della classe Server. 

Tale metodo semplicemente interpreta i byte ricevu- 
ti, ed estrae il testo del messaggio. 
Oltre all'intestazione il messaggio infatti conterrà due 
byte che specificano la lunghezza della stringa suc- 
cessiva, ed appunto una stringa di testo. 

BinaryReader reader = new BinaryReader(new 

MemoryStream(buffer)); 
ushort length = reader.ReadUIntl6(); 
m_Message = new string(reader.ReadChars(length)); 

Il messaggio può poi essere mostrato all'utente, ma- 
gari mediante una interfaccia grafica simile a quella di 
Mule. 
La figura seguente mostra un esempio di client eMu- 
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le personalizzato, che sfruttale precedenti classi e re- 
lativi metodi, subito dopo una connessione riuscita 
ad un server eMule. 
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F/g. 3: Un cWenf Emule scritto in C# 



L'ID viene calcolato in base all'indirizzo IR in quanto 
è questo che influenza la capacità da parte di altri 
client di connettersi direttamente ad un'altra mac- 
china su una data porta. 

Se il server a cui ci si connette non riesce ad aprire 
una connessione TCP verso il client, esso assegnerà 
un ID basso. Ciò accade generalmente se si utilizza 
un firewall per bloccare determinate porte. Un ID bas- 
so si avrà anche se ci si connette attraverso NAT o 
proxy o se il server è troppo occupato. 
Un ID viene calcolato secondo la seguente formula: se 
l'IP del client è X.Y.Z. W; l'ID sarà pari al valore X +2 *8*Y 
+2 A 16 *Z +2A24*W. Se valore risultante è inferiore a 
16777216 (in esadecimale 0x1000000) si tratta di un 
ID basso. 




Non si esporrà nell'articolo come realizzare l'inter- 
faccia grafica, argomento che prescinde dai nostri 
scopi, ricordando comunque che il progetto è inclu- 
so nel ed in allegato alla rivista. 
Riprendendo il case Protocol.ServerCommand.ID- 
Change dello switch nel precedente metodo il mes- 
saggio di IDChange viene trattato nel seguente mo- 
do: 



RICERCA DEI FILE 

Per avviare la ricerca di un file nella rete eMule basta 
utilizzare il comando Search Request, a cui server 
risponderà con un comando Search Result contenen- 
te l'elenco degli eventuali risultati. 
La figura 4 mostra lo scambio di messaggi per una ri- 
cerca di file. 



BinaryReader reader = new BinaryReader(new 

MemoryStream(packet)); 
m_ID = reader.ReadUInt32(); 
if (reader. PeekChar() > 0) 



Client 



Server 



{ 



m_Server.TCPFIags = reader.ReadUInt32(); 



} 



Else m_Server.TCPFIags = 0; 

basta leggere un intero per ottenere l'ID e poi verifica- 
re se il server ha specificato altri flag. Attualmente è 
possibile che il server spedisca infatti altri 4 byte, e se 
il valore convertito in intero è 1 indica che è suppor- 
tata la compressione. 



ID ALTO O BASSO? 

In risposta alla richiesta di login, un server che accet- 
ta la connessione invierà anche un messaggio chia- 
mato ID Change, che assegna un ID al client in base 
a determinati parametri. 

Il client ID è un identificatore a 4 byte ed è valido so- 
lo per il ciclo di vita di una session di connessione 
client-server. I client ID possono essere distinti in al- 
ti e bassi. Un ID Basso viene in genere assegnato da 
un server quando questi si accorge che il client non 
può accettare connessioni in ingresso. Avere un ID 
basso diminuisce le potenzialità di utilizzo della rete 
eMule, diminuendo notevolemente le capacità di 
download, in quanto il server dovrà agire da interme- 
diario nello scambio dei file. 



Start time 
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End time 



serper 



status- 



4 _lound3DU t ne^ 



Fig. 4: Scambio di messaggi per la ricerca dei file 



Nel comando di ricerca è possibile specificare i diver- 
si parametri da utilizzare, come la dimensione mas- 
sima o minima dei file, il tipo di contenuto da rierca- 
re, l'estensione e così via. 

La risposta del server è se tutto va bene un comando 
SearchResult, in cui viene specificato il numero n di ri- 
sultati, e quindi di seguito n elementi in un determi- 
nato formato. Il codice della classe SearchResult ri- 
portato in parte qui di seguito, mostra come è possi- 
bile interpretare il messaggio dei risultati: 
Il costruttore legge il numero di risultati nRes e poi 
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esegue un ciclo for per ricavare i dati dei file trovati. 

public SearchResults(MemoryStream 

buffer,FileSearcher searcher) 

1 

BinaryReader reader=new 

BinaryReader(buffer); 
uint nRes=reader.ReadUInt32(); 
for (uint i = 0; i < nRes; i++) 

{ 

ExtractResult(reader,searcher); 



} 



Il metodo ExtractResult legge la parte seguente del 
messaggio interpretando i singoli tag. Per ogni risul- 
tato ricava dunque il nome, la dimensione, il nume- 
ro di sorgenti, l'id del file, o altri parametri come il bi- 
trate o l'artista se si tratta per esempio di un mp3. 

private uint ExtractResult(BinaryReader 

reader,FileSearcher search) 

1 

TagReader tagReader; 

byte[] hash = reader.ReadBytes(16); 

uint ip = reader.ReadUInt32(); 

ushort port = reader.ReadUIntl6(); 

uint nParams = reader.ReadUInt32(); 

string fileName = "?"; 

uint fileSize = 0; 

uint nSources = 1; 

string codec=""; 

uint bitrate=0; 

string length=""; 

bool complete=false; 

for (uint param = 0; param != nParams; 

param++) 

{ 

tagReader = new 

TagReader(reader); 
switch( 

(Protocol. FileTag)tagReader.id ) 

{ 

case 
Protocol. FileTag.Na me: 
fileName = 
tagReader.strVal; 
break; 



Protocol. FileTag.Size: 
fileSize = 
tagReader. numVal; 
break; 
case 

Protocol. FileTag.Sources: 
nSources = tagReader.numVal; 



break; 



case 
Protocol. FileTag.Completed: 



complete = tagReader.numVal > 0; 



break; 



default: 



if 
(tagReader. name= = Protocol. Fi leExtraTags.codec.ToSt 

ring()) 



codec= tagReader.strVal; 



else if (tagReader.name 
Protocol. FìleExtraTags.length.ToStringO) 



length = tagReader.strVal; 



else if (tagReader.name 
Protocol. FileExtraTags.bitrate.ToStringO) 



bitrate = tagReader.numVal; 



break; 



return nSources; 



} 



La figura 5 mostra la nostra applicazione subito dopo 
aver effettuato una ricerca del termine "acdc". 
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Fig. 5: Finestra con i risultati di una ricerca 



CONCLUSIONI 

Nell'articolo si è visto come funziona il protocollo 
eMule, e come sfruttare le classi messe a disposizioni 
da .NET per implementare dei meccanismi di comu- 
nicazione con i server della rete peer-to-peer di eMu- 
le. Al termine dell'articolo siamo in grado di imple- 
mentare un nostro client per ottenere da esso mas- 
simo delle prestazioni. La tecnologia è decisamente raf- 
finata e studiando il protocollo si può implementare 
una propria rete P2P, strutturata magari appositamen- 
te per gestire le esigenze di comunicazione e di inter- 
scambio dati all'interno della propria rete aziendale. 
La migrazione a .NET inoltre consente performance 
di tutto rispetto. 

Antonio Pelleriti 
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DOJO E JAVASCRIPT 
E TUTTO E SEMPLICE 

IMPARIAMO AD USARE UNO DEI FRAMEWORK EMERGENTI PER AJAX. ARCHITETTURA 
A COMPONENTI E GESTIONE DEGLI EVENTI. AL TERMINE DELL'ARTICOLO SAREMO 
IN GRADO DI PROGRAMMARE ALCUNE FORM MOLTO SPECIALI. VEDIAMO COME... 
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Dojo è uno dei framework Javascript più 
completi e versatili, ed è liberamente 
scaricabile dal sito http://doiotoolkit.orq . 
Per mezzo di tale framework possiamo aggiun- 
gere alla nostra applicazione, in modo davvero 
semplice e intuitivo, innumerevoli funzionalità 
interattive basate su sofisticati componenti 
DHTML, drag & drop, animazioni, richieste 
Ajax. 

Similmente ad altri framework particolarmente 
ambiziosi ed "impegnati", anche Dojo si basa 
"pesantemente" sull'approccio alla program- 
mazione orientata ai componenti, e questo 
aspetto, com'è facile intuire, semplifica molto la 
vita agli sviluppatori che se ne avvalgono per 
realizzare complesse web-application. I compo- 
nenti DHTML forniti da Dojo ("widget") sono 
inseribili nella pagina utilizzando un semplice 
linguaggio di markup, molto intuitivo e rapido 
da apprendere, che non obbliga lo sviluppatore 
a conoscere il funzionamento dell'architettura 
sottostante. L'aspetto visuale dei vari widget è 
poi liberamente modificabile agendo sui tem- 
plate html e sui file CSS, forniti a corredo dei 
componenti stessi. 

L'efficiente struttura a "package" (librerie) su 
cui è basato il framework, infine, grazie alla 
modularità che la caratterizza, permette poi allo 
sviluppatore di includere nell'applicazione sol- 
tanto le classi veramente necessarie, a tutto 
vantaggio quindi dell'organizzazione e della 
pulizia del codice. 

"Fin qui, niente di nuovo", starà sicuramente 
pensando qualche lettore che in fatto di fra- 
mework ha già una discreta familiarità. A dire il 
vero, infatti, sono molte le librerie che presenta- 
no caratteristiche e vantaggi simili a quelli 
appena elencati. Ma quali sono, allora, i reali 
vantaggi, rispetto alla maggior parte dei fra- 
mework, che possono incoraggiare il lettore a 
puntare su una soluzione complessa ed avanza- 
ta come Dojo ? 

Ebbene, intanto bisogna ricordare che Dojo 
garantisce la portabilità dei propri componenti 



non soltanto in HTML, ma anche in altri forma- 
ti, come SVG, aspetto questo di non scarsa rile- 
vanza in uno scenario, come quello attuale, 
sempre più orientato a far conciliare e integrare 
tra di loro le più differenti tecnologie Web. 
Da rimarcare, peraltro, la grande completezza e 
versatilità del framework, che presenta una 
straordinaria varietà di componenti, alcuni dei 
quali davvero molto interessanti. Solo per citar- 
ne due dei più rappresentativi: 

• un completo editor WYSIWYG di testi 
("dojo.widget. Editor"), facile da includere 
nella pagina, che consente di lavorare con il 
browser come se si trattasse di un vero e pro- 
prio programma di editing; 

• un potente e versatile motore per la genera- 
zione di grafici in formato SVG ("dojo.wid- 
get.Chart"). 

Vediamo ora di analizzare un po' più nel dettaglio il 
funzionamento del framework Dojo, partendo 
naturalmente dalle principali basi teoriche. 






.1. 




il 



Fig. 2: Ecco un esempio di grafico SVG elaborato da 
Dojo: 



FUNZIONI DI UTILITÀ 
DI DOJO 

Come ogni buon framework che si rispetti, Dojo 
offre una vasta gamma di funzioni di utilità, 
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destinate a molteplici scopi. 
Prima di poter usare le utility di Dojo, però, dob- 
biamo linkare il file che ne include l'intera logi- 
ca di funzionamento: 

<script type = "text/javascript" 

src="dojo.js"x/script> 

Vediamo ora le principali librerie generiche che 
ci mette a disposizione Dojo. 
Innanzi tutto, va citata la dojo.dom, che come si 
può facilmente intuire fornisce utili scorciatoie 
e semplificazioni per l'accesso al Document 
Object Model. 

Se però siamo interessati più che altro alla 
manipolazione di tag HTML, dobbiamo allora 
utilizzare la dojo.html, della quale citiamo 
anche alcune funzioni particolarmente signifi- 
cative: 

• getScroll(): 

restituisce un oggetto che ha le proprietà top e 
left valorizzate sulla base dello scrollTop e dello 
scrollLeft del documento HTML; 

• gè tElementsBy Class (className, parent, 
nodeType): 

restituisce tutti i tag HTML (discendenti dal 
nodo opzionale parent, rappresentato di default 
dal root del documento) che hanno il 
className e il tipo di nodo specificati; 

• addClass(node, className): 

aggiunge una nuova classe className ad un 
nodo, sovrascrivendo gli stili di altre classi pree- 
sistenti (per effettuare la rimozione delle classi 
specificate dobbiamo invece usare 
removeClass) . 

Dojo ci permette poi di lavorare agevolmente 
anche con gli stili CSS, tramite le funzioni appo- 
site contenute nella libreria dojo.style; per citar- 
ne una: 

• getAbsolutePosition (node, includeScroll): 

restituisce la posizione assoluta dell'elemento 
node all'interno del body, come somma degli 
offset dei vari elementi contenitori (inclusa, 
eventualmente, la barra di scorrimento, la cui 
presenza dipende dal valore del parametro boo- 
leano includeScroll). 

Per includere una classe (o un intero namespa- 
ce) nella pagina, è sufficiente (dopo aver linkato 
il file dojo.js) usare l' istruzione dojo.require. Es. 

dojo.require("dojo.dom"); 
dojo.require("dojo.event.*"); 

Insomma, è evidente che l'utilizzo di queste 



funzioni "prefabbricate" agevola notevolmente 
l'attività dello sviluppatore, che non deve più 
preoccuparsi delle incompatibilità tra i vari 
browser. 

Vediamo ora come lavorare con gli eventi Dojo 
all'interno della nostra pagina HTML. Intanto, è 
bene sapere che per agganciare un event hand- 
ler ad un elemento html possiamo utilizzare 
semplicemente il seguente metodo: 

dojo. event. connect(document.getElementById( "node 
1"), "onclick", "handleOnClick"); 

La riga di codice sopra indicata associa all'even- 
to onclick dell'elemento di id "nodel" la funzio- 
ne handleOnClick. 

Se invece vogliamo associare all'evento una 
funzione anonima, che quindi intendiamo defi- 
nire sul momento, possiamo agire nel seguente 
modo: 

dojo. event. connect(document.getElementById( "node 
1"), "onclick", function(evt) { 
// evt rappresenta un riferimento all'evento valido 

per tutti i browser 

}); 

Senza addentrarci troppo nei meandri della 
programmazione ad oggetti in Javascript, è 
bene comunque precisare che la funzione 
dojo.event.connect permette anche di associare 
una molteplicità di event handler a cascata (ad 
esempio, una serie di metodi statici apparte- 
nenti ad un oggetto che chiamerò obj) al verifi- 
carsi di un determinato evento (o anche solo su 
chiamata di una semplice funzione), attraverso 
un codice simile al seguente: 

dojo. event. connect(obj, "funzionel", obj, 

"funzione2"); 

Il metodo funzione2, in parole semplici, è una 
funzione callback che viene richiamata auto- 
maticamente al termine dell'esecuzione del 
metodo funzionel (pur non essendo, quest'ulti- 
mo, un evento a tutti gli effetti) . 
Come si può vedere, quindi, invocando una 





■iMAZionii coni dojo 



Naturalmente Dojo integra anche 
funzionalità per la gestione delle 
animazioni. Le possibilità offerte 
dal framework annoverano, tra 
l'altro, anche librerie legate alla 

Ì matematica (come dojo.math), che 
consentono la realizzazione di ani- 
mazioni con figure geometriche 



complesse. 

Tuttavia, se l'obiettivo è inserire 
dei semplici effetti animati, allora 
si può tranquillamente ricorrere al- 
la classe dojo. graphics. htmlEf- 
fects, che integra diversi metodi 
per l'implementazione delle più 
comuni tecniche di animazione. 
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semplice API, possiamo evitare di dover gestire 
tutte le differenti implementazioni degli eventi 
tipiche dei vari browser, concentrandoci invece 
solo sui nostri reali obiettivi. 
A questo punto, finalmente, avendo dato uno 
sguardo rapido ma efficace a tutte le principali 
funzionalità offerte da Dojo, abbiamo gli ele- 
menti per introdurre l'argomento clou della 
nostra trattazione sul framework: i widget. 



COSTRUIAMO 

URI EDITOR PER IL WEB 

Quante volte, dovendo realizzare un form per 
l'invìo di dati, abbiamo pensato all'opportunità 
di inserire nella pagina un editor in grado di 
consentire all'utente una qualche formattazio- 
ne dei testi inseriti. Ma ben presto l'entusiasmo 
si spegneva di fronte alla difficoltà di trovare 
componenti compatibili con i principali brow- 
ser, e in grado di assicurare stabilità e sicurezza 
nelle più svariate situazioni. 
Ebbene, l'editor fornito da Dojo è nato proprio 
per rispondere a queste particolari esigenze. 
Esso, infatti, non soltanto consente di lavorare 
direttamente sull'output finale della formatta- 
zione (lasciando quindi il "lavoro sporco" di 
generazione del codice html al framework), ma 
è in grado anche di comportarsi in modo stabi- 
le e sicuro in qualsiasi situazione, senza far cor- 
rere il rischio di perdere dati preziosi. 
Per poter includere l'editor, innanzi tutto, 
occorre inserire nella head della pagina il 
seguente codice: 

<script src="dojo.js" 

type = "text/javascript"x/script> 
< script ty pe = "text/javascript" > 

dojo. require("dojo. widget. Editor"); 
</script> 



CRONOLOGIA E SEGNALIBRI CON AJAX 



Il grande inconveniente 
dell'utilizzo di Ajax è legato al 
fatto che, quando interviene una 
modifica della pagina da remoto, 
l'URL non cambia, e quindi i tasti 
Back e Forward non funzionano 
più come nei siti web tradizionali. 
Dojo consente di intercettare la 
pressione dei due pulsanti, 
mediante le funzioni backButton e 
forwardButton del metodo 
dojo.io.bind, che l'utente può 
costruire a proprio piacimento. In 
questo modo è possibile 
implementare una forma 



personalizzata di cronologia che 
tenga conto anche delle azioni 
Ajax intervenute all'interno della 
pagina. Per preservare la 
funzionalità dei segnalibri, infine, 
è poi possibile specificare un 
parametro all'interno del metodo 
dojo.io.bind (changeURL: true) che 
ad ogni chiamata remota 
aggiunge all'URL della pagina il 
simbolo # seguito da un 
timestamp: questo assicurerà, 
evidentemente, URL diversi ad 
ogni richiesta, rendendo possibile 
l'uso dei bookmark. 



Un editor Dojo è costituito da due widget: Rich 
Text (che contiene il testo da formattare) e 
Toolbar (che rappresenta la barra con i vari pul- 
santi). Inserire un editor Dojo nella pagina è 
decisamente molto semplice: è possibile, infat- 
ti, assegnare la classe dojo-Editor ad un DIV, per 
fare in modo che questo si trasformi in un edi- 
tor in piena regola: 

<div dass="dojo-Editor"> Questo è il 

contenuto </div> 

Oppure si possono inserire degli attributi pro- 
prietari nel tag del DIV, come avviene ad esem- 
pio nel seguente caso: 

<div id = "editable" dojoType="Editor" 

widgetld = "editdiv" 
items="formatblock; |;insertunorderedlist;insertorde 
redlist; |;bold;italic;underl ine; stri kethrough; [; create 

Link;"> 

L'attributo dojoType, in particolare, specifica il 
tipo di widget da istanziare, mentre widgetld 
rappresenta l'identificativo di quel widget 
all'interno della pagina. 

L'attributo items, infine, contiene l'indicazione 
dei vari pulsanti presenti all'interno della tool- 
bar, separati tra di loro da segni di interpunzio- 
ne (;) e suddivisi in raggruppamenti logici 
attraverso il simbolo pipe (|). 



B I U ■ 



Lorem Ipsum 



Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Quisque iaculis, i 
Nunc condunenturn, magna à ? ::::;n;bulum convallis, libero purus pulvinar 01 



Fig. 2: Ecco un esempio di editor Dojo in azione 



Ma come fare poi per recuperare il contenuto 
del nostro editor ? Avevamo accennato, infatti, 
che l'editor fa parte di un form contenente vari 
campi da inviare al server al termine della com- 
pilazione. 

Niente paura: finora abbiamo usato il tag DIV, 
per generare l'editor, ma nulla ci vieta di 
usare altri elementi HTML, ad esempio una 
textarea: 

<textarea dojoType="Editor" name = "textCont"> 

ecco la nostra textarea trasformata in un editor 
</textarea> 

Evidentemente, il valore da inviare al server 
su submit del form sarà costituito dal codice 
html generato da Dojo, e non quindi dal sem- 
plice testo inserito all'interno della textarea. 
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RICHIESTE AJAX 

coni DOJO 

A dire il vero, l'utilizzo dei moduli non è l'unico 
sistema per recuperare il contenuto dell'editor. 
L'invio del contenuto HTML generato dal con- 
trollo (che si può interrogare, ad esempio, 
attraverso il metodo getEditorContentO), può 
avvenire anche attraverso una chiamata asin- 
crona al server. A tale scopo possiamo utilizza- 
re il metodo dojo.io.bind, presente all'interno 
del namespace dojo.io (che contiene le funzio- 
nalità di I/O). 

Lo strato di remoting fornito da Dojo incapsula 
già tutta la logica di gestione delle varie imple- 
mentazioni di Ajax nei differenti browser, met- 
tendoci a disposizione API ad alto livello estre- 
mamente stabili e semplici da utilizzare. 
Qualora, poi, non sìa possibile istanziare l'og- 
getto giusto per l'impiego di Ajax, allora il fra- 
mework si avvale automaticamente del vecchio 
sistema basato su iframe, in modo da consenti- 
re in ogni caso il corretto funzionamento del- 
l'applicazione. 

Ecco un esempio di invio del contenuto di un 
form tramite Dojo: 

dojo.io.bind({ 

uri: "http://...", 

Ioad: function(type, obj) { /* questa è la 

risposta in caso di esito positivo */ }, 
error: function(type, error) { /* questa è 

la risposta in caso di errore */ }, 
formNode: 

document.getElementByld('nameForm') 
} 

In particolare, il parametro type identifica l'esi- 
to della risposta (se è positivo o meno), mentre 
il secondo parametro rappresenta il 
responseText dell'oggetto XmlHttpRequest (nel 
caso della Load) o una chiave per la gestione 
degli errori (nel caso di Error) . 
Esistono poi anche altre opzioni, tramite le 
quali possiamo specificare, ad esempio, il 
metodo della chiamata (post o get), l'invio di 
parametri di richiesta sotto forma di hash (con- 
tenti, la modalità di invio dei dati (sincrona o 
asincrona), l'utilizzo di una eventuale cache 
con cui gestire gli oggetti XmlHttpRequest, 
ecc.. 



DOJO, IL FUTURO 
DEL WEB 2.0 

Dire che Dojo rappresenta il futuro del Web 2.0 
può sembrare azzardato, ma è comunque fuori 
discussione che esso presenta delle funziona- 



lità davvero innovative, ancora pressocché 
introvabili, a tutt'oggi, nell'ambito della comu- 
nità open source. Mi riferisco, evidentemente, a 
Cometd, una libreria che consente di attuare 
un approccio alle comunicazioni asincrone 
decisamente ottimizzato (almeno per quello 
che riguarda le applicazioni "collaborative", 
come ad esempio una chat, dove cioè il client 
deve interrogare continuamente il server per 
aggiornarsi) . 

La grande innovazione apportata da Ajax (se 
mai si può definire una vera e propria innova- 
zione) si limita, in effetti, a rendere asincrona 
l'interazione con il server, ma tale approccio 
resta di fatto sempre e comunque basato sulla 
logica client-server del protocollo HTTP. 
Una volta effettuato lo scambio di comunica- 
zioni tra client e server, infatti, la connessione 
muore. L'approccio basato su Cometd si basa, 
invece, su una connessione persistente, e sulla 
possibilità, da parte del server, di inviare una 
comunicazione al client di propria spontanea 
iniziativa, al verificarsi di determinati eventi, 
evitando quindi continue e inutili richieste di 
auto - aggiornamento. 

Il grosso inconveniente di questo approccio 
alla programmazione web-oriented, che ne 
limita ancora per il momento la diffusione, è la 
necessità di dover disporre, sul server, di un 
componente in grado di gestire le code di mes- 
saggi Cometd (come ad esempio la soluzione 
open source Jetty, il cui sito web di riferimento 
è http://www.mortbav.com/ software/Jettv. ritmi ); 
tuttavia l'idea resta indubbiamente di notevo- 
le interesse, vista la grande novità che rappre- 
senta rispetto alle soluzioni Ajax-based attuali, 
ed è molto probabile che la prossima rivoluzio- 
ne del Web 2.0 volga proprio in tale direzione. 
Insomma, è evidente che, pur essendo ancora in 
evoluzione, Dojo ha già tutte le carte in regola per 
stupire: motivo in più, questo, per seguirne atten- 
tamente gli sviluppi futuri, nella speranza che la 
grande portata innovatrice di questo framework 
possa dare un contributo valido e determinante 
all'intero mondo del Web 2.0. 

Enrico Viale 






Enrico Viale è 
specializzato nello 
sviluppo di 
applicazioni sia web- 
oriented sia desktop. 
Chi desidera 
contattarlo per 
chiarimenti riguardo 
all'articolo, o per 
qualsiasi altro motivo, 
può farlo all'indirizzo 
enrico.viale@qmail.com. 



OS'E SVC ? 



SVG è l'acronimo di Scalante 
Vector Graphics, ed è una 
tecnologia raccomandata come 
standard W3C nel 2001 per la 
generazione di grafica vettoriale. 
Tale tecnologia consente di 
realizzare immagini vettoriali, in 
modo simile a Macromedia Flash, 



ed è basata totalmente su XML. 
SVG è supportato nativamente 
da tutti i browser moderni, 
tranne in qualche caso dove è 
possibile, comunque, installare 
componenti esterni che ne 
garantiscono comunque le 
funzionalità. 
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EFFETTI GRAFICI 
ALVOLOPERILWEB 

IMPAREREMO COME CAMBIARE DINAMICAMENTE LO SFONDO DELLE NOSTRE PAGINE. 
INOLTRE FAREMO IN MODO DI UTILIZZARE UN EFFETTO GRADIENTE E DIMINUIRE IL PESO 
DELLE IMMAGINI SFRUTTANDO IN MODO PARTICOLARE I FOGLI DI STILE 
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Ly introduzione dei fogli di stile CSS ha 
portato un notevole progresso nel desi- 
i gn dei siti Web moderni. 
Una grande quantità di effetti grafici che prima 
richiedevano l'utilizzo di immagini, adesso pos- 
sono essere ottenuti con un semplice CSS. 
Uno degli effetti più "in voga" tra i web designer 
è quello dell'utilizzo dei gradienti di colore, 
basti vedere alcuni dei siti più famosi come 
quello di Yahoo (figura 1). 
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F/g. 1; Utilizzo dei gradienti nel design del sito 
di Yahoo 



Purtroppo alcuni effetti grafici, e tra questi pro- 
prio i gradienti di colore, non sono ottenibili 
con il solo uso dei fogli di stile. 



IMPOSTARE 

I GRADIENTI CORI I CSS 

L'impostazione dei gradienti, come sfondo ad 
alcuni elementi HTML, richiede normalmente, 
oltre ai CSS, l'utilizzo di file grafici (tipicamente 
JPG) di supporto. 
Prendiamo una semplice tabella HTML: 



<tr> 



<th>Nome</th> 



<th>Cognome</th> 



<th>Indirizzo</th> 



</tr> 



<tr> 



<td>Mario</td> 



<td>Bianchi</td> 



<td>Via Verga, 3 Milano</td> 



</tr> 



</table> 

Poniamo di volere applicare un gradiente di 
colore alla testata ed uno alle righe. 
Procederemmo creando, in Photoshop o altro 
editor di immagini, due file grafici con i gra- 
dienti desiderati salvandoli su disco con i nomi, 
ad esempio, gradientel.jpg e gradiente2.jpg 
(figura 2). 



^jnj_xj 



^jnjxj 




Fig. 2: Creazione dei gradienti in Photoshop 



a questo punto, nel foglio di stile è sufficiente 
impostare i file come background degli elemen- 
ti in questione definendo una classe che chia- 
meremo myTable: 
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.myTable { 






margin-top: 


lOpx; 






border: lpx 


#666 solid; 






border-bottc 


im: none; 


} 




.rr 


yTable 


TH { 




background-image: 

url('images/g rad ientel.jpg'); 






background 


position: left; 






background 


repeat: repeat-x; 






background 


color: #999; 


} 


.rr 


yTable 


TD{ 




background-image: 

url('images/g rad iente2.jpg'); 






background 


position: left; 






background 


repeat: repeat-x; 






background 


color: #FFF; 


} 



cioè, in pratica, utilizziamo la proprietà back- 

ground-image per definire quale sarà lo sfondo 

dell'elemento. 

Per collegare quindi la classe CSS alla nostra 

tabella sarà sufficiente utilizzare l'attributo 

class nel codice HTML: 

<table class="myTable"> 

A questo punto potremo ammirare la nostra 
tabella "prima" e "dopo" la cura come mostrato 
in figura 3. 



Esempio 1 - Windows Internet Explo 



>: » |g_, http://localhost/temp/_^| |*t) |_xj | Google 



Elle Edit View Favorites lools Help 
GQl3k |JG'- _j Cerca ^ M " B T | & J> Impo: 



Ù & 



j|-|gE...X 



LA 
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Nome Cognome 



Indirizzo 



|Mano [Bianchi |Via Verga, 3 Milano 



Giorgio [Gialli [Via Petrarca, 10 Firenze 



[Alberto [Rossi 


| Via D ante ,1 Roma 




Nome 


Cognome Indirizzo 


Mario 


Bianchi 


Via Verga, 3 Milano 


Giorgie 


Gialli 


Via Petrarca,10 Firenze 


Alberto 


Rossi 


Via Dante, 1 Roma 



Fig. 3: Tabella formattata con i CSS 



SOLUZIONI 
PROPRIETARIE 

Come abbiamo visto la tecnica di base per la 
realizzazione dei gradienti di sfondo con i CSS 
non è affatto complessa, tuttavia presenta 
anche qualche piccolo inconveniente: 



• Per cambiare i colori di un gradiente dovrem- 
mo editare nuovamente l'immagine 

• Molte volte vorremmo utilizzare la stessa sfu- 
matura di colore per elementi di dimensione 
diversa e quindi siamo costretti a realizzare 
più immagini nelle varie dimensioni 

Poiché il gradiente è un effetto grafico molto 
"smart" per i siti, Microsoft ha aggiunto questo 
effetto nei Visual filters. 

I Visual filters sono, in pratica, delle estensioni 
ai CSS standard mediante l'attributo filter, rico- 
nosciuto e gestito da Internet Explorer fin dalla 
versione 4. La sintassi CSS di questo attributo è 
un po' particolare : 

filter: 

progid:DXImageTransform.Microsoft.gradient(startCo 

lorstr=#0000FF, endColorstr=#FFFF00, 

gradientType=0); 

Le proprietà fondamentali (espresse all'interno 
delle parentesi) sono : 

• startColorstr - colore di inizio in formato 
esadecimale 

• endColorstr - colore finale in formato esade- 
cimale 

• gradientType - tipo di gradiente (verticale) e 
1 (orizzontale), il valore di default è 0. 

Tornando all'esempio fatto in precedenza, la 
classe CSS per formattare la nostra tabella uti- 
lizzando l'attributo filter si presenterebbe così : 



.myTablelE 


{ 








margir 


-top:10px; 






border 


: lpx #666 solic 


; 




border 


-bottom: none; 




} 




.myTablelE TH { 


filter: progic 


:DXImageTran 
endColorstr= 


sform. Microsoft 

artColorstr 

(t3D4167,gradie 


gradient(st 
= #5D6075, 
-itType=0); 


} 




.myTablelE TD { 


filter: progic 


:DXImageTran 
endColorstr= 


sform. Microsoft 

artColorstr 

#F7F7F7,gradie 


gradient(st 
= #CFCFCF, 
ntType=0); 


} 



In figura 4 vediamo il risultato : in IE utilizzan- 
do filter otteniamo lo stesso risultato rispetto 
all'uso di immagini esterne, ma Firefox non 
riconosce la formattazione. 




RIFERIMENTI 
PER IL BACK- 
GROUND CSS 

Un ottimo riferimento 
sui background CSS (e 
i CSS in generale) è 
reperibile su 
http://www.w3schools. 
com/css 
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VISUAL 
FILTERS CSS 

Chi fosse interessato 

ad approfondire i 

Visual filters introdotti 

da Microsoft può 

trovare i riferimenti su 

http://msdnZ. microsoft 

■com/en-us/library/ 

ms532847.aspx 



ie 



G Esempio 1 - Windows Internet EKplorer 
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Mario Bianchi 


Via Verga, 3 Milano 


Giorgio Gialli 


Via Petrarca, 10 Firenze 


Alberto Rossi 


Via Dante, 1 Roma 



Fig. 4: Comparazione dei vari metodi in IE e Firefox 



In effetti il problema è proprio questo: la tecni- 
ca avrebbe tutte le carte in regola per rappre- 
sentare la soluzione del problema (elimina la 
necessità di immagini esterne ed è facilmente 
modificabile editando solo il CSS), tuttavia non 
possiamo dimenticarci della crescente quota di 
utenti che usano Firefox o di chi non usa 
Windows. 



LA GENERAZIONE 
DINAMICA DI GRADIENTI 

La tecnica proposta da Microsoft in IE ci dà 
comunque degli spunti interessanti, soprattut- 
to nel senso di obiettivi da raggiungere: 

1. generazione dinamica e non statica 

2. modifica del solo CSS e non di immagini 

3. manutenibilità 

a questi obiettivi però aggiungiamo anche quel- 
lo della portabilità in tutti i browser (che natu- 
ralmente supportino i CSS) e le piattaforme. 
La soluzione è rappresentata dal ed. "lato ser- 
ver" cioè dalla generazione dinamica di imma- 
gini sul server anziché sul client (come avviene 
nel caso dei Visual filters di Microsoft). 
Piattaforme come ASP.NET sono prevalente- 
mente utilizzate per realizzare dinamicamente 
output di tipo HTML e spesso dimentichiamo 
che possono essere agevolmente sfruttate per 
produrre Streams di qualunque tipo, anche 
immagini. 

Quello che vogliamo ottenere quindi è un pro- 
gramma lato server, rispondente ad una URL, 
che restituisce un'immagine con il gradiente 
desiderato costruito dinamicamente in base ad 
alcuni parametri passati. 



In tal modo potremmo usare i CSS nel modo 
normale, ad esempio: 

background-image: 

url('images/gradient.aspx?startColor=#CCCCCC&en 

dColor=#FFFFFF'); 

con la sola differenza che variando i parametri 

cambierebbe il gradiente. 

Mettiamo quindi mano al codice e creiamo il 

nostro "generatore di gradienti" in .NET 

In Visual Studio impostiamo un nuovo progetto 

Web e vi inseriamo subito un nuovo elemento. 

Al contrario di quello che possiamo pensare, 

non sarà una pagina ASP.NET ma un file di tipo 

"Gestore generico" (figura 5). 
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Fig. 5: Nuovo file di tipo "Gestore generico" 



Tale tipo di file è riconoscibile dall'estensione 
ASHX anziché .ASPX ed è detto HttpHandler. 
Utilizziamo un HttpHandler invece di una pagi- 
na ASP.NET perché, nel nostro caso, non abbia- 
mo bisogno di interfaccia HTML e controlli 
vari: è sufficiente gestire la Pipeline 
Request/Response. 

Un HttpHandler è una classe di struttura molto 
semplice, che implementa l'interfaccia 
IHttpHandler, questo è lo schema predefinito 
creato da Visual Studio: 

<%@ WebHandler Language="VB" Class="Handler" 

%> 

Imports System 

Imports System. Web 

Public Class Handler : Implements IHttpHandler 

Public Sub ProcessRequest(ByVal context As 

HttpContext) Implements 
IHttpHandler.ProcessRequest 
context. Response.ContentType = "text/plain" 
context. Response.Write(" Hello World") 
End Sub 
Public ReadOnly Property IsReusable() As 

Boolean Implements IHttpHandler.IsReusable 
Get 
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Return False 



End Get 



End Property 



End Class 

La proprietà IsReusable definisce se la classe 

può essere utilizzata da un'altra richiesta, nel 

nostro caso è false perché il gradiente generato 

dovrà essere diverso a seconda dei parametri 

passati. 

Il tutto si gioca poi a livello del metodo 

ProcessRequest che regola il flusso di risposta 

al client. 

Nel nostro caso definiremo prima di tutto quali 

sono i parametri richiesti: 

Dim GradientType As String "tipo gradiente 

orizzontale o verticale 
Dim StartColor As Color ' colore di inizio 
Dim EndColor As Color ' colore finale 
Dim GradientLength As Integer 'la larghezza o 
l'altezza del rettangolo contenente il gradiente 

Sempre a livello di classe saranno definite poi 
altre variabili: 



della stringa verranno aggiunti. 
Tutti i parametri vengono recuperati nel meto- 
do ProcessRequest, all'interno del quale viene 
definito anche il rettangolo su cui disegnare. 
Il disegno vero e proprio del gradiente viene 
demandato a una funzione: 

Private Function GetGradientQ As Bitmap 

Dim bmp As New Bitmap(GradientRect.Width, 
GradientRect.Height) 
Dim gBrush As New 

Drawing2D. Linea rGradientBrush(GradientRect, 
StartColor, EndColor, Mode) 




Dim g As Graphics 



Graphics. Fromlmage(bmp) 



g.FillRectangle(gBrush, GradientRect) 



Return bmp 



End Function 

Naturalmente rimandiamo agli esempi allegati 
per un esame più completo del codice, ci basti 
dire qui che, una volta costruito il gradiente, nel 
metodo ProcessRequest, definiremo la scrittura 
dell'immagine nell'output: 



Dim GradientRect As Rectangle 'il rettangolo su 

cui disegnare il gradiente 
Dim Mode As Drawing2D.LinearGradientMode 'il 
tipo di gradiente espresso come valore enum 



Dim bmp As Bitmap = GetGradientQ 
response.ContentType = "image/jpeg" 
bmp.Save(response.OutputStream, 

Imaging.ImageFormat.Jpeg) 



I parametri saranno ricavati dalla QueryString. 
Qui abbiamo una particolarità: nella uri il 
carattere # non si può usare così come nella 
QueryString perché sarebbe interpretato come 
riferimento ad un Bookmark, quindi i colori in 
formato esadecimale dovrebbero essere 
espressi con i caratteri di escape, ad esempio 
come %23FFFFFF invece che # FFFFFF, prefe- 
riamo allora omettere del tutto il cancelletto e 
realizzare una funzione che, al bisogno, lo 
aggiunge: 

Private Function TryParseColor(ByVal s As 

String) As Color 
Dim result As Color = Color.Black 
Try 

result = ColorTranslator.FromHtml(s) 
Catch ex As Exception 



If Not s.StartsWith("#") Then 



result = TryParseColor("#" & s) 



End If 



End Try 



Return result 



End Function 



in questo modo, anche se nella nostra URL i 
cancelletti non ci sono, in fase di valutazione 



UTILIZZO 

DEL GENERATORE 

I nomi dei parametri che abbiamo definito nel 
codice sono: 

• start - colore di partenza del gradiente in 
formato esadecimale (#FFFFFF) o named 
colours (white) 

• end - colore di arrivo del gradiente in forma- 
to esadecimale o named colours 

• direction - direzione del gradiente (horizon- 
tal e vertical) 

• size - se il gradiente è orizzontale rappresen- 
ta la larghezza del rettangolo altrimenti l'al- 
tezza, l'altro lato invece sarà sempre di lOpx 
perché l'immagine può essere ripetuta attra- 
verso i CSS. 

Quindi la URL per richiamare il nostro genera- 
tore sarà qualcosa di simile a: 

gradient.ashx?direction = horizontal&size = 300&start 

=00FF00&end = red 

e, se carichiamo la URL nel browser, avremo come 
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& 



USO 
DEL CODICE 
ALLEGATO 

Per utilizzare il codice 

allegato al CD è 

necessario salvare la 

directory con gli 

esempi nel disco fisso 

e configurarla come 

directory virtuale di MS 

nella macchina di 

destinazione 



risultato l'immagine che appare in figura 6. 
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Fig. 6: il generatore in "azione" 



a maggior conferma del fatto che si tratta di una 
vera e propria immagine, del tutto simile a una 
JPG statica possiamo usarla nel codice HTML 
proprio come faremmo con qualsiasi altra 
immagine: 




background-repeat: repeat-x; 



} 



Il risultato che otterremo (Figura 7) sarà del 
tutto simile al precedente con il vantaggio però 
che per cambiare i colori basterà cambiare i 
valori dei parametri anziché sostituire le imma- 
gini. Insomma un metodo del tutto simile al fil- 
ter di IE, ma compatibile con tutti i browser! 
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Tabella formattata con CSS e Gradienti dinamici 



Nome Cognome Indirizzo 


Mario Bianchi 


Via Vergai Milano 


Giorgio Gialli 


Via PetrarcajlO Firenze 


Alberto Rossi 


Via Dante,! Roma 
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Fig. 7: il generatore in combinazione con i CSS 




ANCHE IN PHP 

La tecnica illustrata in 

questo articolo può 

essere utilizzata anche 

con altri linguaggi lato 

server che dispongano 

di funzioni grafiche. 

In particolare in PHP 

esiste una piccola 

classe che genera 

gradienti scaricabile 

da 

http://frenchfraqfactor 

y.net/ozh/my- 

projects/imaqes-php- 

qd-qradient-fill . 



uso coni i css 

Passiamo quindi al vero e proprio scopo del 
nostro generatore di gradienti: quello di essere 
usato in combinazione con i CSS. 
Riprendiamo quindi il nostro primo esempio, i 
gradienti utilizzati come sfondo di una tabella. 
Ridefiniamo quindi la classe CSS della tabella 
utilizzando la URL del nostro generatore al 
posto delle immagini statiche: 

.myTable { 
margin-top:10px; 
border: lpx #666 solid; 
border-bottom: none; 



} 



.myTable TH { 



backg round-i mage: 
url('gradient.ashx?direction=vertical&size=30&start 
= 5D6075&end = 3D4167'); 



background-position: left; 



background-repeat: repeat-x; 



} 



.myTable TD { 



backg round-i mage: 
url('gradient.ashx?direction=verticalcksize=30&.start 
= CFCFCF&end = F7F7F7'); 



background-position: left; 



PERFEZIONAMENTI 

Il fatto di avere a disposizione una piattaforma 
server come .NET ci porta a risolvere con suc- 
cesso un altro problema, quello della colloca- 
zione del file. 

L'indirizzo dell'immagine impostata come 
background nel CSS è relativo alla collocazione 
del CSS, quindi se l'immagine ha un percorso 
tipo / immagini/bg.jpg e il foglio di stile uno 
come Icss/style.css in quest'ultimo il back- 
ground andrà impostato come: 

background-image: url('. ./immagini/bg.jpg '); 

se però sposto il foglio di stile in un'altra posi- 
zione, ad esempio in /css/altrapath/style.css, il 
riferimento dovrà essere : 

background-image: url('../.. /immagini/bg.jpg '); 

Questo ovviamente riduce la "portabilità" del 
foglio di stile perché costringe a cambiare le 
path; senza parlare dei casi in cui si utilizza una 
classe CSS direttamente nel documento HTML 
con il tag <STYLE> o con l'attributo style di un 
elemento. 

Il problema non è risolto con il generatore dina- 
mico perché essendo anch'esso un file (di esten- 
sione .ashx) si comporta esattamente come un 
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file grafico statico per quanto riguarda i riferi- 
menti. 

La soluzione consiste nel trasferire il codice del 
nostro generatore ad una classe all'interno della 
cartella App_Code del nostro sito. 
Quindi, in Visual Studio, creiamo un file di codi- 
ce in App_Code chiamandolo GradientHandler. 
ub nel file copieremo il codice di Gradient.ashx 
inserendo anche un namespace (non è obbliga- 
torio, ma è più elegante): 



Imports System 


Imports System. Web 


Imports System. Drawing 


Namespace Handlers 


Public Class GradientHandler 


Implements 

IHttpHandler 




'codice della classe ... 




End Class 


End Namespace 



In questo modo V HttpHandler verrà inserito 
nella libreria generata in fase di runtime da 
ASP.NET. 

A questo punto, nel file web.config dell'applica- 
zione, dovremo inserire il riferimento all'hand- 



ler in questo modo: 

<httpHandlers> 



<add path = "GradientHandler.ashx" verb = "*" 
va lidate= "false" type="Handlers.GradientHandler"/> 

</httpHandlers> 

Il fatto di avere impostato l'attributo validate su 
false significa che il file non dovrà essere neces- 
sariamente presente su disco e che viene richia- 
mata la classe di tipo Handlers. Gradient 
Handler ogni volta che si fa riferimento a un 
nome di file (virtuale) corrispondente a 
GradientHandler. ashx, qualunque sia la sua 
posizione. 

A questo punto, qualunque sia la posizione del 
file CSS, sarà sempre possibile usare : 
background-image: url('gradient.ashx?ecc... '); 
Come ulteriore perfezionamento potremo 
anche introdurre nel codice il caching delle 
immagini associando ogni URL alla corrispetti- 
va bitmap da conservare in memoria senza 
doverla ricostruire ad ogni richiesta ed incre- 
mentando così le prestazioni del generatore. 

Francesco Smelzo 
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sviluppo in ambiente 
Windows con 
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di dispositivi USB che permette di riconoscere ed autenticare univocamente 
d e di stabilire con esso transazioni protette e crittoqrafate su reti Internet, 



Intranet, Extranet. Ideali per risolvere in modo semplice e funzionale i problemi di gestione e di replicabilità 
sistemi basati su user name e password e per migliorare l'usabilità e la sicurezza dei dispositivi OTP tradizionali 
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SVILUPPA PER 
ILWEBCONYUI 

IMPARIAMO A LAVORARE CON IL FRAMEWORK UTILIZZATO DA YAHOO PER SVILUPPARE 
APPLICATIVI SUL WEB DOTATI DI UNA CERTA COMPLESSITÀ. AL TERMINE DELL'ARTICOLO 
AVREMO GETTATO LE BASI PER GESTIRE UN CALENDARIO PERPETUO 
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o sviluppo di un sito Web può apparire, al 
tempo stesso, estremamente semplice o 
terribilmente complicato, a seconda dei 
punti di vista: tutto dipende, da numerosi fatto- 
ri. 
Per citarne alcuni: 

• innanzitutto, il livello di sicurezza che inten- 
diamo implementare (e questo, naturalmen- 
te, apre un ventaglio di problematiche di non 
poco conto); 

• da non trascurare, peraltro, il numero di 
browser e tecnologie di cui vogliamo assicura- 
re la compatibilità; 

• infine, è importante poi considerare il target 
di riferimento del sito, inteso come l'insieme 
dei potenziali utilizzatori dello stesso, con le 
loro esigenze e le loro aspettative. 

Se l'impatto grafico non è poi così importante, 
allora possiamo tranquillamente dedicarci sol- 
tanto all'aspetto funzionale; talvolta, però, 
anche l'occhio vuole la sua parte, soprattutto 
nei siti che pubblicizzano prodotti commercia- 
li. Un sito "vetrina" deve da un lato essere fun- 
zionale, e rispondere con precisione e sollecitu- 
dine alle richieste degli utenti, dall'altro essere 
"piacevole", e spingere i visitatori (anche solo 
occasionali) ad inserirlo nel bookmark del pro- 
prio browser. Ma come fare a rispondere oppor- 
tunamente a tutte queste esigenze in un colpo 
solo? 

Se il sito è di piccole dimensioni, conviene forse 
curarne personalmente tanto la forma quanto il 
contenuto, ma se l'applicazione comincia ad 
essere particolarmente complessa, allora, con- 
viene sicuramente affidarsi ad un framework 
specializzato, in grado di velocizzare l'attività di 
sviluppo senza farci perdere di vista l'obiettivo 
principale del nostro lavoro, il framework YUI. 
In questo articolo tratteremo, in particolar 
modo, le librerie YUI, scaricabili liberamente 
dal sito della Yahoo (http://developer. 
yahoo.com/yui/), che raccolgono una serie infi- 
nita di funzionalità atte ad agevolare lo sviluppo 



di siti Web complessi. 

Le YUI, peraltro, sfruttano tutta la potenza e l'e- 
leganza del paradigma object-oriented, associa- 
to al linguaggio Javascript su cui sono basate. 
L'uso di un framework specializzato risolve, 
infine, un altro annoso problema dello svilup- 
patore Web: l'aggiornamento delle proprie 
applicazioni. Per tenere un'applicazione sem- 
pre aggiornata, infatti, basterà semplicemente 
(in linea di massima) aggiornare il framework 
all'ultima versione disponibile, senza toccare, 
invece, 1' "ossatura" del progetto stesso, rappre- 
sentata dal codice inserito direttamente dallo 
sviluppatore. 

Il codice di esempio messo a disposizione dalle 
librerie, oltre a fornire numerose spiegazioni 
tecniche e un motore di ricerca completo per 
navigare tutte le funzionalità principali, integra 
anche strumenti di logging che tengono traccia 
di tutto ciò che avviene durante le varie fasi di 
funzionamento dell'applicazione (eventi, erro- 
ri, tempi di esecuzione del codice, ecc.). 



GLI EVENTI COIU YUI 

Cominciamo ora ad esaminare le classi princi- 
pali del framework YUI, con un occhio di riguar- 
do, in particolare, alle loro caratteristiche più 
importanti e utili per lo sviluppatore. 
Siccome però il metodo migliore per analizzare 
un framework complesso come YUI è lavorare 
direttamente su degli esempi pratici, vi propon- 
go qui di seguito il seguente file: 

<html> 

<head> 

<link rel = "stylesheet" type = "text/css" 

href="./yui/build/calendar/assets/calendar.css"> 

<!— Dependencies — > 

<script type="text/javascript" 

src="./yui/build/yahoo-dom-event/yahoo- 

dom-event.js" > </script> 
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<!-- Source file and calendar css --> 
<script type = "text/javascript" 
src="./yui/build/calendar/ 



calendar-min.]s"x/script> 



</head> 



<body> 



<div id = "callContainer"x/div> 



<script> 



var cali; 



function init() { 



cali = new 

YAHOO. widget.Calendar("call","callContainer"); 



call.render(); 



} 



YAHOO. util.Event.addl_istener(window, "load", init); 



</script> 



</body> 



</html> 



) Mozilla Firefox 
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Fig. 2: il calendario di YUI in azione 



Questo file, presente all'interno dei quickstart di 
esempio di YUI, inserisce nella pagina web, con 
poche righe di codice, un calendario perpetuo 
perfettamente funzionante, che sfrutta unica- 
mente funzioni YUI. 

Sorpresi, eh? Niente di magico, tuttavia; sempli- 
cemente abbiamo utilizzato una delle funziona- 
lità più interessanti del framework YUI: il con- 
trollo Calendario, implementato dalla classe 
YAHOO.widget.Calendar. Le classi della utility 
YAHOO.widget mettono a disposizione dello 
sviluppatore tutta una serie di controlli davvero 
interessanti, alcuni dei quali ancora in fase di 
beta-testing (ovviamente, per le mie valutazioni, 
faccio riferimento alla versione delle librerie più 
aggiornata fino a questo momento, che è la 
2.2.0), altri invece (come appunto il calendario) 
perfettamente funzionanti e pronti per essere 
utilizzati nelle nostre applicazioni. 
Avremo modo di nuovo, nella prossima puntata, 
di analizzare meglio altri controlli della utility 
YAHOO.widget, in questa occasione vogliamo 
invece soffermarci più che altro sugli aspetti 
fondamentali del loro funzionamento, e più in 
generale del funzionamento degli oggetti YUI, a 
cominciare dalla gestione degli eventi. 
Importando il file yahoo-dom-event.js, posto 
all'interno del framework, abbiamo a disposi- 
zione una serie di funzioni che ci consentono di 
interagire con facilità con gli eventi DOM della 
pagina web. 

Il file importa inoltre il foglio di stile associato al 
calendario (dato di default da YUI, ma potrem- 
mo linkarne anche uno scritto da noi), e il file 
che inserisce le funzionalità per la creazione del 
controllo stesso (calendar- min.js). 
L'ultima riga del tag script interno al body, infi- 
ne, aggancia al caricamento della pagina la fun- 
zione init, che si limita a creare una nuova istan- 



za dell'oggetto Calendario da posizionare all'in- 
terno del div callContainer, stampato poi a 
video dalla successiva chiamata al metodo ren- 
der. 

Per agganciare un gestore di evento al carica- 
mento della pagina, viene utilizzato il metodo 
addListener, il quale definisce una funzione 
callback che viene richiamata automaticamente 
non appena termina il caricamento della pagi- 
na. 

La funzione init(), quindi, rappresenta un event 
handler ("gestore di evento") associato all'even- 



BUGGARE LE APPLICAZIONI WEB 



L'immagine qui sotto, visualizza la 
console di debug: 
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Questa console si può inserire nella 
pagina nel seguente modo: 

1) innanzitutto, copiamo queste ri- 
ghe nella head della pagina (solo 
il file logger.js, comunque, è vera- 
mente necessario per poter creare 
l'istanza della console): 
<script type="text/javascript" 

src="js/yui/build/event/event- 
debug.js"x/script> 
<script type="text/javascript" 



src="js/yui/build/logger/logger.js"> 
</script> 

2) per assegnare uno stile alla con- 
sole, linkiamo il seguente file CSS: 

<link type="text/css" rel = "style- 
sheet" href="js/yui/build/logger/as 
sets/logger.css"> 

3) per istanziare il controllo, inseria- 
mo nel body della pagina il se- 
guente codice: 

var oLogReader = new YAHOO. wid 
get. Log Reader(null, {top :"4em", font 
Size:"92%",width:"30em",height: 
"20em"}); 

E' evidente che questi strumenti ve- 
locizzano di gran lunga la realizza- 
zione di siti web complessi, dando al 
programmatore una piacevole sen- 
sazione di "controllo totale" della 
propria attività di sviluppo, difficil- 
mente ottenibile con altri software 
disponibili gratuitamente sulla rete 
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COS'È 
FIREBUG? 

Alcuni browser sono 

integrabili con 

programmi o 

estensioni che ne 

arricchiscono 

notevolmente le 

funzionalità di base. 

L'articolo cita, in 

particolar modo, 

Firebug, che 

rappresenta una delle 

più famose estensioni 

del browser Firefox, 

utilissima (assieme ad 

altre, come ad 

esempio Web 

Developer) per 

supportare l'attività 

dello sviluppatore 

Web. 

Firebug mette a 

disposizione dello 

sviluppatore diversi 

strumenti di 

debugging del codice 

Javascript, inoltre 

fornisce informazioni 

dettagliate e in tempo 

reale sulle 

caratteristiche della 

pagina corrente, 

inerenti il codice html, 

css, le richieste Ajax, 

ecc.. 



to load dell'oggetto window. Naturalmente è 
possibile agganciare più di un event handler ad 
un oggetto, quando si vuole gestire una molte- 
plicità di eventi per l'oggetto stesso. 
I gestori di evento possono poi essere rimossi 
agevolmente tramite le funzioni 

removeListener (se intendiamo rimuovere uno 
o più event handler specificati) o 
purgeElement (se vogliamo invece rimuovere 
tutti gli handler associati ad un determinato 
elemento). Quest'ultima funzione, peraltro, 
dispone di un parametro (di tipo boolean, che 
quindi accetta solo due valori: true o false) che 
specifica se la rimozione degli event handler 
deve interessare in modo ricorsivo anche tutti 
gli elementi di livello inferiore ("figli") a quello 
preso in considerazione. 

Con estrema facilità, quindi, possiamo aggan- 
ciare alla nostra applicazione web una molte- 
plicità di gestori d'evento, mentre con la stessa 
disinvoltura è poi possibile rimuoverli o modifi- 
carli a seconda delle esigenze particolari del 
momento. 

Osserviamo ora, con particolare attenzione, il 
semplice script posto all'interno del seguente 
codice html: 



<html> 


<head> 


<script> 


document.getElementById(" 


testo 


").val 


ue= 


nuovo_ 
valore"; 


</script> 


</head> 


<body> 




<input type = "text" 


id = ' 


testo 


va 


lue=""> 


</body> 


</html> 



Il browser restituirà, naturalmente, un errore, 
perché lo script cerca di referenziare un oggetto 
quando il DOM (Document Object Model) non 
è ancora disponibile. 

Nell'esempio del calendario il problema non si 
poneva, perché la funzione initQ veniva esegui- 



COME POSSO FARE PER INSTALLARE LE YUI ? 



Le librerie YUI sono scaricabili gra- 
tuitamente dal seguente sito di 
Yahoo, http://developer.yahoo.com/yui. 
dedicato alla comunità degli svilup- 
patori. 

Il progetto YUI, peraltro, facendo 
parte della comunità opensource, è 
disponibile anche sul sito http://sour- 
ceforge.net/projects/yui . 



Per installare il framework è suf- 
ficiente scaricarlo da Internet e 
scompattarlo; a questo punto, 
quindi, se si vuole integrare il 
proprio sito con funzionalità YUI 
basta copiare i file .js interessati 
e le loro dipendenze direttamen- 
te all'interno della cartella del si- 
to stesso. 



ta al termine dell'evento di caricamento, men- 
tre in questo caso lo script, essendo eseguito in 
anticipo rispetto al codice html nel flusso di 
caricamento della pagina, si trova a dover lavo- 
rare su oggetti che non esistono ancora. 
Per evitare questo errore, si potrebbe inserire 
tale riga di codice subito dopo il tag html che 
definisce il campo di testo, ma solitamente le 
funzioni legate al DOM vengono eseguite diret- 
tamente su onload della pagina (che scatta solo 
dopo il caricamento completo del documento, 
con conseguente perdita di tempo). 
Ora, le YUI rendono disponibile la funzione 
onAvailable, facente sempre parte dell'utility 
YAHOO.util.Event, che esegue lo script interes- 
sato non appena il DOM dell'oggetto è disponi- 
bile. Questo indubbiamente velocizza l'esecu- 
zione del codice all'interno della pagina, men- 
tre lascia la libertà allo sviluppatore di "accen- 
trare" la gestione del DOM anche interamente 
in un solo file .js, posto magari all'interno della 
sezione head, senza doversi preoccupare di 
problematiche legate agli eventi. 
Sempre all'interno dell'utility 

YAHOO.util.Event troviamo, poi, un'altra fun- 
zione molto utile: preventDefault. Questa fun- 
zione, semplicemente, vieta al browser, in occa- 
sione del verificarsi di un determinato evento, 
di comportarsi secondo le sue impostazioni di 
default (consente, quindi, un maggiore control- 
lo allo sviluppatore che non deve più preoccu- 
parsi dei comportamenti specifici di ogni sin- 
golo browser). 



MANIPOLARE 
IL DOM CORI YUI 

Alzi la mano chi non ha mai avuto problemi con 
la gestione del DOM in una pagina web di una 
certa complessità. 

Per quanto estremamente utile, infatti, il DOM 
ha il difetto di generare righe di codice lunghis- 
sime, in molte situazioni dove la struttura degli 
elementi html è abbastanza sofisticata: per aiu- 
tarci in queste attività ci viene in aiuto il DOM 
di YUI. 

Innanzitutto, una funzione veramente utile è 
getXY: essa restituisce la posizione X e Y di un 
oggetto all'interno della pagina web (senza 
questa funzione dovremmo calcolare manual- 
mente, con un ciclo, la distanza dell'elemento 
in questione dal vertice superiore sinistro del 
document, come somma delle varie distanze di 
ogni singolo elemento rispetto al suo conteni- 
tore, fino ad arrivare al body !). Vale la pena, 
poi, di citare altre due funzioni interessanti: 
getClientHeight e getClientWidth, che restitui- 
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scono rispettivamente l'altezza e la larghezza 
della pagina corrente. 

Immaginiamo ora di voler cambiare a run-time 
la classe CSS associata ad un elemento; in java- 
script questa compito può essere eseguito dal 
seguente codice: 



elemento=document.getElementById ("elemento"); 
elemento. className="nuova_classe"; 

Con queste due righe raggiungiamo con facilità 
il nostro risultato, tuttavia cosa succederebbe 
se volessimo ripristinare la situazione che c'era 
in precedenza ? 

Dovremmo memorizzare, per esempio, in un 
array globale, tutte le varie classi riferite alle 
diverse situazioni, in modo da poter rintraccia- 
re più agevolmente la classe che ci interessa. 
Tuttavia sarebbe molto più semplice aggiunge- 
re la nuova classe a quella già esistente, in 
modo da limitarci a sovrascrivere gli stili di 
quest'ultima (senza quindi effettuare realmen- 
te una sostituzione): quando poi vogliamo 
ritornare alla situazione precedente, semplice- 
mente rimuoviamo la classe appena aggiunta. 
Le librerie YUI consentono questi "giochetti" 
con una certa facilità; ad esempio, per aggiun- 
gere una classe a quelle eventualmente già esi- 
stenti, usiamo la seguente istruzione: 

YAHOO. util.Dom.addClass('contenitore', 

'modifica_contieni'); 

Firebug (nota estensione del browser Firefox 
utile per gli sviluppatori web, di cui faccio degli 
accenni in un box apposito), a questo punto, 
segnalerà la presenza di più classi CSS sull'ele- 
mento in questione, separandole con uno spa- 
zio (es. class="modifica modifica_contieni"), 
mentre visualizzerà gli stili della classe sovra- 
scritta cancellati con una barra orizzontale: 
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Fig. 3: uno screenshoot di firebug in azione 



Per rimuovere la classe appena aggiunta, al 
contrario, dovremo utilizzare quest'altra riga di 



codice: 

YAHOO. util.Dom.removeClass('contenitore', 

'modifica_contieni'); 

Le funzioni DOM di YUI non si limitano però 
soltanto a fornire utili strumenti per la mani- 
polazione delle classi CSS: tramite esse pos- 
siamo anche svolgere molte altre operazioni, 
come settare gli stili, visualizzarne le pro- 
prietà, ecc.. 

Un esempio per tutti: per modificare il valore 
di uno stile, usando la notazione YUI, possia- 
mo operare nel modo seguente: 

YAHOO. util.Dom.setStyle('content', 'display', 'block'); 

Tramite tale riga abbiamo modificato la pro- 
prietà display dell'elemento di id "content", 
impostandone il valore a "block". 
Insomma, è evidente che YUI ci aiuta moltissi- 
mo nella nostra attività di sviluppo, rispar- 
miandoci spesso i tanti e fastidiosi problemi di 
compatibilità tra i vari browser, e i "malditesta" 
che altrimenti dovremmo sopportare per ren- 
dere le nostre applicazioni sempre e costante- 
mente aggiornate e al passo con il progresso del 
Web. 



CONCLUSIONI 

In questa puntata ci siamo limitati ad introdur- 
re una carrellata di funzioni di utilità, dando 
solo un piccolo assaggio delle tante e "golose" 
(in senso metaforico, s'intende !) novità intro- 
dotte dalle librerie YUI. 

Nel prossimo numero, invece, come anche 
annunciato più sopra, affronteremo casi prati- 
ci, creando finestre, pannelli con eventi asso- 
ciati, interazioni asincrone con server remoti 
(Ajax), animazioni, ecc.. 

L'imperativo, quindi, è solo uno: non perdete 
assolutamente il prossimo numero. 

Enrico Viale 
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ME POSSO VELOCIZZARE L'APPLICAZIONE? 



Inserire tanti file .js nella sezione 
head della pagina non migliora, 
di sicuro, la velocità di download 
della stessa. YUI mette quindi a 
disposizione delle versioni 
"compresse" dei suoi file .js, che 
terminano con il suffisso -min, 
tuttavia quando i file inclusi sono 



troppi conviene in ogni caso 
organizzare diversamente il 
codice (per esempio, inglobando 
il codice Javascript scritto da noi 
in un solo file .js invece che 
distribuirlo su più file), per 
evitare un decadimento generale 
delle prestazioni del sito 
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UN EDITOR HTML 
NELLE TUE PAGINE 

IN QUESTO ARTICOLO IMPAREREMO COME REALIZZARE DELLE FORM MOLTO PARTICOLARI 
ATTRAVERSO LE QUALI È POSSIBILE INSERIRE IN UN DATABASE TESTI FORMATTATI IN PIENO 
STILE WORD PROCESSOR. FAREMO TUTTO QUESTO SOLO USANDO JAVASCRIPT 




Utilizzando servizi di Web Mail come quelli di 
Yahoo o Google, vi sarà capitato di incon- 
trare sicuramente il Rich Text Editing, nor- 
malmente nella finestra "Nuovo Messaggio", sotto 
forma di un controllo nella pagina dove l'utente può 
scrivere del testo formattato (grassetto, corsivo, tipo 
di carattere, colore ecc...)- 
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F/g. 1: ff/c/i Texf Editing di GMail 



l'oggetto document su "On". 

2. La possibilità di rendere editabili solo alcuni ele- 
menti della pagina (come ad esempio i tag DIV) o 
impostandone l'attributo CONTENTEDITABLE 
su "true" oppure impostando, attraverso il DOM, 
la proprietà contentEditable, sempre su true, del- 
l'elemento. 

Nel primo caso occorrerà impostare la proprietà 
designMode nell'evento onLoad: 

<html> 

<headx/head> 

<body onload= "document. designMode='On'"> 

</body> 

</html> 

Nel secondo caso possiamo impostare l'attributo 
sull'elemento: 



in 




REQUISITI 



L Javascript e DOM 
I HTML a livello medio 



ì Nessuno 



J J J I .! 

00000 



Ebbene, tali controlli si basano su specifiche funzio- <html> 
nalità di alcuni browser (Firefox, Mozilla e Opera) <headx/head> 
che consentono di impostare il documento, o una <body> 
area di esso, come editabile dall'utente. 
Praticamente come le textarea o gli input, ma con la 
possibilità di formattazione del contenuto ottenuta </body> 
con l'HTML. Bisogna precisare che queste funziona- 
lità non sono codificate come standard e quindi 
ogni browser fornisce un approccio talora anche 
molto diverso al problema. 



<div id="editableArea" 

contentEditable="true"x/div> 



</html> 
oppure farlo a livello di script: 

<html> 



<head> 



ENTRARE IIM MODALITÀ 
EDITING COIU IE E OPERA 

Internet Explorer ha l'indubbio merito di aver intro- 
dotto, fin dalla versione 5, le funzionalità di editing 
integrate nel browser e presenta a tutt'oggi, a mio 
avviso, la migliore implementazione. </script> 

Il browser di Microsoft consente di impostare due </head> 
modalità di editing : <body> 

l.La possibilità di rendere editabile l'intero docu- 
mento impostando la proprietà designMode del- </body> 



<script language="javascript" 



type="text/javascript"> 



window.onload = function () { 



document.getElementById("editableArea").contentE 

ditable=true; 



<div id="editableArea"x/div> 
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</html> 



ENTRARE IIM MODALITÀ 
EDITING COI\l FIREFOX 

Firefox, a differenza di IE e Opera, non consente l'e- 
ditabilità di un singolo elemento della pagina, ma ha 
soltanto la possibilità di rendere editabile l'intero 
documento, sempre attraverso l'impostazione su on 
della proprietà designMode dell'oggetto document, 
come abbiamo visto nel primo esempio. 
Questo in pratica ci costringe a dedicare all'editor 
una Fraine o IFrame separata nella pagina per avere 
la possibilità di avere una Toolbar esterna all'area 
editabile (altrimenti sarebbe editabile anch'essa). 



ci resta quindi che tenere conto delle limitazioni di 
Firefox e inserire la parte editabile in Frame o IFrame 
separate. Procediamo dunque a sviluppare un pic- 
colo esempio per fissare meglio i concetti. In una 
directory, quindi creeremo due file HTML: 

1. 11 primo, chiamiamolo esempio.html, conterrà 

un'/Frame. 
2. il secondo, editor.html, occuperà l' IFrame. 

Quindi il codice di esempio.html, sarà pressappoco : 




D'ACCORDO TUTTI 

Volendo sviluppare una soluzione cross-browser non 



<html> 


<meta http-equiv="content-type" 

content="text/html; charset= 


ISO-8859-l"/> 


<head> 


</head> 


<body> 




<div 


id="Toolbar' 


></div> 








<ifra 
ieight= 


ne id="edit" 
"200" marg 


width=" 
nheight= 


100%" 

="0" marginwidth="0" 
src="editor.html"/> 




Per chi ha bisogno di un editor HTML affi- 
dabile già pronto è senz'altro consigliabi- 
le l'ottimo FCKEditor 
(www.fckeditor.net), un progetto Open 
Source di Frederico Caldeira Knabben. 
FCKEditor si può integrare con i più diffu- 
si linguaggi lato server (ASP.ASP.NET, 
Perl, PHP, Python ed altri ancora) oppure 
può essere usato lato client. 
Implementare FCKEditor richiede un po' 
di apprendimento anche perché la sua 
struttura è molto ricca di funzionalità ed 
anche estendibile attraverso plugin. 
Vediamo, in estrema sintesi, un'imple- 
mentazione di base. 

INSTALLAZIONE 

Scarichiamo i file della libreria e decom- 
primiamo la directory contenente tali fi- 
le nel sito da sviluppare (ad esempio 
C:\miosito\editor). 

Nel codice HTML della pagina che deve 
ospitare l'editor inseriamo il riferimento 
alla libreria rappresentata dal file fckedi- 
tor.js : 

<head> 



<title>FCKeditor - Sample</title> 



<script type="text/javascript" 



src="editor/fckeditor.js"x/script> 



</head> 

UTILIZZO 

A questo punto è sufficiente instanziare 
l'editor nel corpo del documento HTML 
con un semplice script 



<form action = "sampleposteddata.asp" 

method = "post" target="_blank"> 
<script type="text/java 
script"> 
<!-- 
var oFCKeditor = new FCKeditor( 'FCKeditorl' ) 

oFCKeditor.BasePath = 

document.location. pattinarne; 
oFCKeditor.Height = 300 ; 
oFCKeditor.Value = This is some 

<strong>sample text<Vstrong>. You are 

using <a 

h ref = " http ://www.fcked itor. net/" > FCKed i 

tor<Va>.' ; 

oFCKeditor.Create() ; 

//--> 

</script> 

<br/> 

<input type="submit" va 
lue="Submit" /> 
</form> 

Come notiamo sono stati impostati alcu- 
ni parametri dell'oggetto FCKeditor. 

• BasePath - la directory corrente, relati- 
va a dov'è collocata la libreria 

• Height - altezza del controllo in pixel 

• Value - il testo vero e proprio 

Infine viene richiamato il metodo Crea- 
te() per costruire il codice HTML necessa- 



rio. Se tutto è andato bene la pagina si 
dovrebbe presentare come vediamo in fi- 
gura A, con l'editor in bella mostra 
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DOCUMENTAZIONE 

Naturalmente nella vita reale le cose so- 
no ben più complicate, a cominciare con 
l'integrazione con il lato server e la confi- 
gurazione della libreria; ci viene però in 
aiuto il sito di documentazione del pro- 
getto (http://wiki.fckeditor.net) abba- 
stanza dettagliato. 

LIMITI 

Naturalmente ogni medaglia ha il suo 
"rovescio", quello di FCKEditor è che pro- 
prio a causa della ricchezza di funziona- 
lità, la libreria risulta un po' pesante da 
caricare (addirittura anche su connessio- 
ni locali); questo la rende adatta ad esse- 
re utilizzata più su ambienti Intranet che 
sul Web vero e proprio, e comunque è 
certamente da evitare l'uso nelle pagine 
chiave del sito come la Home. 
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</body> 



</html> 

mentre editor.html, sarà: 
<html> 



<headx/head> 



<body contentEditable="true" 

onload="document.designMode='On'"> 



</body> 



</html> 

in modo da funzionare sicuramente con i tre brow- 
ser. Se adesso apriamo con uno dei browser (per 
Opera occorre la versione 9) la pagina esempio.html 
noteremo che nella IFrame (quella dell'editor ) pos- 
siamo scrivere liberamente. Fin qui nulla di molto 
diverso da una comune textarea, dovremo infatti 
occuparci del modo in cui impostare la formattazio- 
ne del testo. 



LA FORMATTAZIONE 
DEL TESTO 

Per fortuna la formattazione del testo è, concettual- 



mente simile, tra i vari browser: eseguire il metodo 
execCommand su document o su un area selezio- 
nata. execCommand accetta i seguenti parametri: 

• Nome del comando - indica appunto la stringa 
identificativa del comando (come poi vedremo) 

• Flag interfaccia utente - indica se attivare l'inter- 
faccia Utente, ad esempio una finestra di dialogo 
per i colori ecc. . . , in pratica però questo parame- 
tro viene sempre settato a false perché il compor- 
tamento dell'interfaccia non è uniforme in tutti i 
browser. 

• Valore - il valore da passare, se necessario, al co- 
mando; se non viene utilizzato va impostato a 
nuli. 

Vediamo quindi, una tabella sinottica, quali sono i 
principali comandi che possono essere impartiti. 
L'applicazione dei comandi avviene appunto richia- 
mando il metodo execCommand sull'oggetto docu- 
ment della Frame o IFrame che ospita il documento 
editabile: 

<script language="javascript" 



r COMANDO VALORE COMPORTAMENTO 


IE 


FF OP 


backColor 


colore In IE imposta lo sfondo del testo selezionato, 

in Firefox e in Opera imposta lo sfondo del documento 


X 


X 


X 


bold 


Nessuno Imposta o rimuove la formattazione in grassetto 
del testo selezionato 


X 


X 


X 


copy 


nessuno 


Copia il testo selezionato negli appunti di sistema 


X* 


X* 


X* 


createBookmark 


nome anchor Inserisce un Bookmark intorno al testo selezionato X 
con il nome passato come valore 






createlink 


uri (href) Inserisce un link intorno al testo selezionato all'uri 
passato come valore 


X 


X 


X 


cut 


nessuno Taglia il testo selezionato e lo mette negli appunti 
di sistema 


X* 


X* 


X* 


decreasefontsize 


nessuno Aggiunge il tag <small> intorno al testo selezionato 
riducendone le dimensioni 




X 


X 


delete 


nessuno Cancella il testo e gli oggetti selezionati 


X 


X 


X 


fontname 


nome Imposta il nome del carattere della selezione 


X 


X 


X 


fontsize 


valore da 1 a 7 Imposta la grandezza del carattere 


X 


X 


X 


forecolor 


Colore Imposta il colore del testo 


X 


X 


X 


Formatblock 


<h1xh2> ecc.. Imposta lo stile del blocco di testo selezionato 


X 


X 


X 


Heading 


<h1xh2> ecc.. Simile a formatblock, ma solo per gli stili Heading 


X 


X 


X 


increasefontsize 


nessuno Aggiunge il tag <big> intorno al testo selezionato 
aumentandone le dimensioni 




X 


X 


indent 


nessuno Indenta il blocco di testo dov'è posizionato il cursore. 


X 


X 


X 


inserthorizontalrule nessuno inserisce una linea orizzontale (<hr>) 


X 


X 


X 


inserthtml stringa html Inserisce del codice HTML dov'è posizionato il cursore. 




X 


X J 
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COMANDO VALORE COMPORTAMENTO 


IE 




FF 


OP 




^^^^^^^^^^^^■1 ■ 




1 


insertimage 


uri (src) 


Inserisce un'immagine (dall'uri passato) 
dov'è posizionato il cursore. 


X 


X 


X 


insertorderedlist 


nessuno 


Inserisce o elimina una lista numerata 


X 


X 


X 


insertunorderedlist 


nessuno 


Inserisce o elimina una lista puntata 


X 


X 


X 


insertparagraph nessuno 


Inserisce un paragrafo <P> 


X 


X 


X 


italic 


nessuno 


Imposta o rimuove la formattazione in corsivo 
del testo selezionato 


X 


X 


X 


justifycenter, 
justifyfull, justifyleft, 
justifyright 


nessuno 


Imposta l'allineamento del paragrafo corrente 


X 


X 


X 


outdent 


nessuno 


Fa rientrare una precedente indentazione del testo 


X 


X 


X 


paste 


nessuno 


Incolla testo dagli appunti 


X* 


X* 


X* 


redo 


nessuno 


Ripristina ciò che è stato in precedenza annullato 
con il comando UNDO 




X 


X 


removeformat 


nessuno 


Rimuove la formattazione 


X 


X 


X 


Selectall 


nessuno 


Seleziona tutto 


X 


X 


X 


strikethrough 


nessuno 


Imposta la formattazione di testo attraversato 
da linea 




X 


X 


styleWithCSS 


true 
false 


Usa i CSS per i comandi di formattazione anziché 
i tag HTML 




X 


X 


underlìne 


nessuno 


Aggiunge il tag <u> intorno al testo selezionato 
facendolo apparire sottolineato 


X 


X 


X 


undo 


nessuno 


Annulla un azione precedente 




X 


X 


unlink 


nessuno 


Rimuove un link 


X 


X 


X J 



in alcuni browser ci possono essere restrizioni di sicurezza per i comandi specificati 



type="text/javascript"> 



function applyBoldQ { 



var iframe = document.getElementById("edit"); 
iframe 

.contentWindow.document.execCommand("bold",fals 

e,null); 

J 

</script> 



<iframe id="edit"> 



UNA PRIMA 
APPLICAZIONE 

Vediamo adesso come mettere insieme quello che 
abbiamo visto in una prima, semplice, applicazione 
di Rich Text Editing. I file che abbiamo visto in pre- 
cedenza, lo ricordiamo, rappresentano il contenito- 
re (esempio.html) e il documento editabile conte- 
nuto nell'IFrame (editor.html). Il nostro scopo sarà 
quello di avere una Toolbar con i fondamentali 
comandi di formattazione: 



• Sottolineato 

• Allineamento a sinistra 

• Allineamento centrato 

• Allineamento a destra 

• Elenco numerato 

• Elenco puntato 

Definiamo quindi l'HTML del contenitore (esem- 
pio.html) così: 

<html> 
<head> 

<title>Editor Demo</title> 

<script language="javascript" 

type="text/]avascript"> 
</script> 
</head> 
<body> 

<div id="Toolbar"x/div> 

<iframe id="edit" src="editor.html" 

width="100%" height="200px"x/iframe> 

</body> 
</html> 



Grassetto 
Corsivo 



dove: 

• L'elemento DIV con id Toolbar è quello che ospi- 
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terà la nostra tabella degli strumenti. 
• L'elemento IFRAME con id edit è la finestra che 
contiene il testo editabile. 

Quindi, per prima cosa, definiamo, in Javascript, un 
array di comandi espressi come oggetti: 



function exec (name){ 



var editor : 



document.getElementById("edit") 



editor.contentWindow.document.execCommand(name 

,false,null); 



} 




DOCUMENTA- 
ZIONE 

La documentazione e i 

riferimenti sul Rich 

Text Editing possono 

essere reperite in rete: 

per IE in 

http://msdn.microsoft. 

com/workshop/author/ 

editing/editing 

entry.asp 

per Firefox in 

http://www.mozilla. 

orq/editor/ 

midas-spec.html 

per Opera la 

documentazione non è 

certo 

abbondantissima, 

comunque il sito di 

riferimento è 

http://dev.opera.com 



var commands = [ 




{name 


'bold',arg:null,icon 


'bold'}, 




{name 


'italic',arg:null,icon 


'italic'}, 




{name 


'underline',arg:null 


icom'underline'}, 




{name 


'sep'}, 






{name 


'justifyleft',arg:null 


icom'alignl'}, 




{name 


'justifycenter',arg:null,icon:'alignc'}. 




{name 


'justifyright',arg:nu 


l,icon:'alignr'}, 




{name 


'sep'}, 




{name: 


'insertorderedlist',arg:null,icon:'numlist'}, 


{name: 


'insertunorderedlist',arg:null, 


con:'bullets'} 


]; 



dove name sarà comando da richiamare, arg il 
valore da passare (per questi comandi sempre nuli) 
e icon il nome del file della GIF che rappresenta il 
comando. 

Passiamo quindi a definire la funzione di costruzio- 
ne della Toolbar, attraverso una tabella generata 
dinamicamente che contiene i pulsanti: 



function setupToolbar (){ 



var ToolbarTable = 

document.createElement("table"); 
var ToolbarRow = ToolbarTable. insertRow(- 



i); 



for(var i=0;i<commands.length;i++){ 



var ToolbarCell = 

ToolbarRow.insertCell(-l); 



var command = commands[i]; 



if(command.name!="sep") { 



ToolbarCell. innerHTML= 
'<img src="images/' + command. icon + '.gif" >'; 
ToolbarCell. onclick = 
new Function ('exec('" + command. name + '")'); 



} 



else ToolbarCell. innerHTML= 



'  



} 



document.getElementById("Toolbar").appendChild 

(ToolbarTable); 



} 



come potete osservare utilizziamo l'array di coman- 
di per definire il contenuto delle celle e l'evento 
onclick sul pulsante che punta alla funzione exec ed 
infine appendiamo il nodo ToolbarTable all'elemen- 
to Toolbar che abbiamo definito nel codice HTML. 
La funzione exec prende semplicemente il nome del 
comando e lo passa ad execCommand dell'oggetto 
document della finestra dell'editor: 



Il terzo parametro della funzione execCommand è 
sempre impostato a nuli perché i comandi che 
abbiamo preso in considerazione non richiedono 
un valore. 

Infine, nell'evento onload di window ci assicuriamo 
che la proprietà designMode del documento editabi- 
le sia su "on" e richiamiamo la funzione 
setupToolbar: 

window.onload = function () { 

var doc = 
document. getElementById('edit').contentWindow. 
document; 

doc. designMode = "on"; 

setupToolbar(); 
} 

Alla fine del nostro lavoro apriamo la pagina in nei 
tre browser è potremmo vedere il nostro mini-editor 
in azione (figura 2). 
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Fig. 2: Rich Text Editor su strada 



Certo, non è ancora paragonabile a Word, tuttavia è 
già un primo passo. . . 



ALTRI ELEMENTI TECNICI 

Naturalmente per creare un vero e proprio editor 
completo di tutte le funzionalità manca ancora 
qualcosa. Nel nostro esempio, per non disperderci 
inutilmente in troppi dettagli implementativi, 
abbiamo visto solo i comandi più semplici, c'è però 
da prevedere la possibilità di: 

• impostare il colore del testo 

• impostare il font del testo 
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• impostare le dimensioni del testo 

• impostare e rimuovere dei link 

• impostare immagini 

Comunque i concetti di base non cambiano, soltan- 
to che qui dovremo prevedere meccanismi più sofi- 
sticati di interazione con l'utente, come finestre di 
dialogo, pop-up ecc.. 

Un altro task importante da implementare sarebbe 
la sensibilità al contesto della toolbar, mi spiego 
meglio, sarebbe opportuno che quando il cursore si 
trova sopra un elemento formattato, ad esempio in 
grassetto, il relativo bottone venisse in qualche 
modo evidenziato, un po' come succede in Word. 
Il comando per controllare lo stato della formatta- 
zione del testo su cui insiste il cursore è 
queiyCommandValue dell'oggetto document della 
finestra editabile. 

Il comando agisce come execCommand, anch'esso 
accetta come parametro il nome del comando, solo 
che restituisce lo stato della formattazione. 
Ad esempio : 

document.queryCommandValue("bold"); 

restituirà true/false a seconda della formattazione 
corrente, o ancora 

document.queryCommandValue("fontName"); 

restituirà il nome del carattere della formattazione 
corrente. E così via. 

Quindi, usando queiyCommandValue, si potrebbe 
innescare, su onmouseup e onkeyup sulla finestra 
dell'editor, un meccanismo di messaggi alla Toolbar 
per settare lo stato dei vari controlli: 

window.onload = function () { 
var win = 

document.getElementById('edit').contentWindow 
var doc = win. document; 



doc.onmouseup = doc.onkeyup 



editorChange; 



} 

//comandi da monitorare 



var queryCommands = 

['boldVitalic'/underlineVjustifyleftVjustifycenterVjust 

ifyright']; 



//funzione di aggiornamento 



function editorChange (){ 



var editorDoc = 
document. getElementById("edit"). contentWindow.doc 

ument; 
for(var i=0;i<queryCommands.length;i++){ 



var b = 
editorDoc.queryCornmandvalue(queryCommand); 
var cmdButton = 
document. getElementById("btn" + queryCommand); 
if(!b) 
cmdButton. className="toolbarButton" 
else 
cmdButton. classlMame="toolbarButtonOn"; 



queryCommand=queryCommands[i" 



INTEGRAZIONE 

COI\l IL LATO SERVER 

Lo scopo principale del nostro Rich Text Editor sarà 
ovviamente quello di comunicare con il server per 
processare le informazioni immesse dall'utente. 
Per far questo occorre naturalmente, per prima 
cosa, recuperare il codice HTML generato dalla for- 
mattazione del testo. Per farlo è sufficiente far riferi- 
mento alla proprietà innerHTML del dell'oggetto 
document.body della finestra editabile, in questo 
modo : 

function save (){ 

var editorDoc = 
document.getElementById("edit"). contentWindow.doc 

ument; 
var code =editorDoc.body.innerHTML; 
alert(code); 
} 

naturalmente in questo esempio il codice viene solo 
mostrato in una finestra di dialogo, mentre in un 
caso reale dovrà essere inviato al server con un POST 
nascosto o con XMLHttpRequest. 



PERCHE SVILUPPARE 
Ul\l RICH TEXT EDITOR? 

Nel web ci sono già da tempo diversi editor di que- 
sto tipo, perché quindi la fatica di svilupparlo da soli 
Per due ottimi motivi: 

1 . conoscere la tecnica che sta alla base del Rich Text 
Editing nei vari browser ci consente di avere un 
maggior controllo anche nell'uso di librerie svi- 
luppate da altri e anche, perché no, aggiungere 
funzionalità mancanti. 

2. le librerie disponibili sul web, dovendo giusta- 
mente prevedere numerosi casi d'uso sono per 
forza di cosa "generaliste", E possono raggiungere 
una complessità e una pesantezza che non ci 
occorre 

Enrico Viale 




RISORSE 
IN RETE 

Per chi proprio non 
volesse "fare da solo" 
oltre all'ottimo 
FCKEditor (solo per IE 
e Firefox) di cui 
abbiamo già parlato 
c'è TinyMCE che copre 
tutti i Browser (IE, 
Firefox, Opera e 
Safari) scaricabile 
all'indirizzo 
http://tinymce. 
moxiecode.com . 
Una lista 

particolarmente ricca 
dei Rich Text Editor 
disponibili è invece su 
http://www.qeni isoft. e 
om/showcase.nsf/Web 
Editors 
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ALLA SCOPERTA 
DEGLI INTERCEPTOR 

ALLA NOSTRA APPLICAZIONE È GIUNTA UNA RICHIESTA, POSSIAMO GESTIRLA FACILMENTE 
CON UNA ACTION, MA COME FARE SE VOLESSIMO "MANIPOLARLA" PRIMA CHE ESSA SIA 
GESTITA? LA RISPOSTA È CONTENUTA IN QUESTO ARTICOLO 




LI CD LI WEB 

STRUTS.Zip 



VL 



ISX 






Le Action, che sono già state ampiamente 
analizzate nei precedenti articoli dedicati 
al nuovo framework, racchiudono 
sostanzialmente la componente controller del 
design pattern MVC implementato da Struts 2. 
È difatti nella action che si invocano i metodi di 
business logie, si raccolgono eventuali risultati 
e si seleziona la vista a cui demandare la 
responsabilità di visualizzarli. 
Gli interceptor, invece, sono degli oggetti che 
"circondano" ogni action, elaborando la richie- 
sta prima che questa giunga alla stessa ed ela- 
borando la risposta generata. Un interceptor, 
oltre a racchiudere una action, può essere posi- 
zionato in modo da elaborare la richiesta e la 
risposta rispettivamente passate e restituite da 
un altro interceptor a valle. Questa possibilità 
che è la vera caratteristica saliente degli inter- 
ceptor offre la possibilità di costruire catene 
che possono modificare anche in modo notevo- 
le il comportamento di Strut 2. 
Durante i primi esperimenti con Struts 2 non ci 
si accorge neanche della presenza degli inter- 
ceptor ma questi, a ragione, ne rappresentano 
la vera anima in quanto tutte le comodissime 
funzionalità fornite dal framework tra le quali 
citiamo la localizzazione con la sostituzione 
automatica dei messaggi tradotti e la validazio- 
ne dei campi delle form con l'eventuale ripre- 
sentazione dei dati errati e dei messaggi esplica- 
tivi, sono funzionalità implementate attraverso 
gli interceptor. 

Struts 2 prevede una serie di default di intercep- 
tor che vengono applicati ad ogni action che 
non specifichi nessuna configurazione partico- 
lare. Il cosiddetto stack di default prevede ben 
17 interceptor che lavorano dietro le quinte per 
offrire vari servizi. Tra i tanti interceptor ricor- 
diamo i seguenti: 

• Exception: mappa una particolare eccezione 
al nome di una vista. 

• Prepare: richiama un metodo di inizializza- 
zione della Action nel caso questa implemen- 



ti una determinata interfaccia. 

• I18n: gestisce la memorizzazione del locale 
per l'utente corrente. 

• Debugging: permette di attivare il debug delle 
viste. 

• FileUpload: per una gestione più semplice 
dell'upload dei file 

• Validation: esegue la validazione dei dati forni- 
ti nella form congruentemente al contenuto 
dei relativi file xml di definizione dei controlli. 

Oltre agli interceptor inclusi nello stack di 
default ne esistono molti altri non inclusi per- 
ché utili in situazioni particolari e non in ogni 
caso. In questo articolo vedremo come utilizza- 
re uno degli interceptor messi a disposizione da 
Struts 2: waitAndExecute. 



IL PROBLEMA 

Durante questa serie di articoli abbiamo svilup- 
pato un'applicazione dedicata al mondo immo- 
biliare attraverso la quale sostanzialmente un 
utente è in grado di cercare tra gli immobili 
offerti dalla agenzia quelli venduti ad un prezzo 
compreso in una determinata fascia. 
Negli esempi finora mostrati la ricerca veniva 
portata a termine in un tempo irrisorio. Nel 
caso però ci si dovesse riferire ad una ricerca più 
completa su database, o attraverso qualche web 
service, la ricerca avverrebbe sicuramente in un 
tempo maggiore. 

In un tale scenario sarebbe controproducente 
far attendere l'utente sino a che la pagina con i 
risultati non venga visualizzata. Molto meglio 
sarebbe visualizzare una pagina di cortesia che 
informi il possibile acquirente che la ricerca è in 
corso, e magari sia anche in grado di fornire gra- 
ficamente una stima del tempo di attesa rima- 
sto, magari attraverso una progress bar. 
L'interceptor "executeAndWait" di Strut 2 è pro- 
prio stato pensato con questo scenario in 
mente. Sostanzialmente questo interceptor ese- 
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gue una action in background e attende per un 
certo tempo che la stessa termini. In questo 
caso il risultato viene passato alla vista selezio- 
nata dalla action e quindi l'interceptor risulta 
totalmente ininfluente. Se però la action non 
termina nel tempo stabilito l'interceptor passa 
alla vista "wait" rendendo disponibile alla stessa 
proprio la action che intanto è in esecuzione. 
Non rimane altro da fare che realizzare la vista 
"wait" in modo che tramite un reload ricaricari- 
chi la pagina dei risultati. L'interceptor conti- 
nuerà a reindirizzare la richiesta sulla pagina di 
attesa sino a quando la action non sarà termina- 
ta e i dati diverranno disponibili. 
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Fig. 1: La finestra di ricerca non ha subito modifiche 
per l'inserimento dellàinterceptor. 



SIMULAZIONE DI UNA 
ACTION COni LUNGHI 
TEMPI DI ESECUZIONE 

La Action di ricerca Search offre il metodo 
getFoundProposals() che sarà invocato all'inter- 
no della vista per ottenere i risultati richiesti. 
Nel metodo execute() viene richiamato il meto- 
do slowFindO che simula la chiamata ad un 
DAO che ha la responsabilità di fornire i risulta- 
ti. I metodi setProposalsToCheckQ e 
setCheckedProposalsO permettono ad un 
oggetto di impostare il numero di proposte che 
saranno restituite e quanti oggetti sono stati 
effettivamente caricati. Tramite questi due 
parametri la action è in grado di fornire un indi- 
ce di completamento del lavoro facendo un 
semplice rapporto tra le due quantità. Questo 
risultato e riportato dal metodo getProgress() e 
potrà variare tra (esecuzione appena iniziata) 
e 1 (esecuzione completata). 

package corri. danidemi.realestate; 

public class Search extends ActionSupport { 
private Integer minValue; 
private Integer maxValue; 
private Set<Proposal> foundProposals; 



private int proposalsToCheck = 0; 


private int checkedProposals = 0; 


public Integer getMaxValue() {...} 




public void setMaxValue(Integer maxValue) 

{■■■} 




public Integer getMinValueQ {...} 




public void setMinValue(Integer minValue) 

{...} 


public String execute() throws Exception { 


if(minValue > maxValue){ 


addActionError("II 
valore minimo deve essere inferiore a quello 

massimo."); 


return INPUT; 


} 




Portfolio portfolio = 

Portfolio. instanceQ; 


foundProposals = 

portfolio.slowFind(this); 


return SUCCESS; 


} 


public Set<Proposal> getFoundProposalsQ 

{■■■} 


public void setProposalsToCheck(int i) { 


this. proposalsToCheck = i; 


} 


public void setCheckedProposals(int 

checked) { 


this. checkedProposals = checked; 


} 


public doublé getProgress(){ 


doublé progress = 0; 


if(proposalsToCheck! = 0){ 


progress = 
checkedProposals / proposalsToCheck; 


} 


return progress; 


} 


public void resetProgressQ { 


setChecked Proposa ls(0); 


setProposalsToCheck(O); 


} 


} 




ESEGUIRE LA RICERCA 

La ricerca degli immobili che soddisfano i parame- 
tri impostati deve avvenire più lentamente. I ritardi 
dovuti ad esempio ad una accesso ad un database 
sono qui simulati inserendo una chiamata a 
Thread.sleepO per ogni proposta che viene carica- 
ta. In questo modo si cerca di palesare il comporta- 
mento dell'interceptor. Per ogni proposta caricata 
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viene inoltre richiamato il metodo 
setCheckedProposalO in modo che la ricerca possa 
calcolare di volta in volta la percentuale di lavoro 
completato. 

public Set<Proposal> slowFind(Search 

search){ 
HashSet<Proposal> result = new 
HashSeK Proposa l>(); 
search.resetProgress(); 
search.setProposalsToCheck(portfolio.size()); 



int checked = 0; 



for (Proposai proposai 



portfolio) { 



Thread.yield(); 



search.setCheckedProposals(checked); 
if(proposal.isValueInRange(search.getMinValue(), 

search.getMaxValue())){ 



result. add(proposal); 



} 



checked + + ; 



try { 



Thread.sleep(400); 



} catch 
(InterruptedException e) { 



// TODO 
Auto-generated catch block 



e.printStackTrace(); 



} 



return result. isEmptyQ ? nuli : 

result; 
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File Modifica Visualizza Vai Segnalibri Strumenti Guida 



o 



Qj |@ http://127.0.0.1:8080/realestate |W Q Vai ||^, 



Ricerca in corso. Attendere. 

Clicca qui se la pagina non si ricarica entro 5 secondi. 



Tue Apr 03 2007 00:25:26 GMT-H3200 (CEST) 



ie 



Fig. 2: Ecco come viene visualizzata la pagina di attesa nello stato iniziale. 



CONFIGURAZIONE 
DELL' INTERCEPTOR 

L'interceptor viene configurato all'interno della 
definizione della action nel file struts.xml. 
Per fare ciò si usa il tag interceptor-ref che si 
riferisce ad interceptor o catene di interceptor 
preconfigurate. 

In questo caso il primo tag si riferisce allo stack 
di default di Struts 2. Questo viene in realtà 
"montato" attorno all'interceptor execAndWait 



che si occupa di selezionare la vista di attesa nel 
caso la action non termini per tempo. Come 
abbiamo già visto nei precedenti articoli una 
vista è sostanzialmente definita da un nome. 
L'interceptor execAndWait restituisce "wait" 
nel caso la Action che sottintende non termini 
per tempo, altrimenti restituisce l'identificativo 
restituito dalla action stessa. Va da se quindi 
che dobbiamo prevedere una nuova pagina nel 
caso la vista selezionata sia "wait". 
Il parametro "delay" indica i millisecondi per i 
quali l'interceptor attenderà prima di selezio- 
nare la vista "wait". 

<action name="Search" 

class="com.danidemi.realestate.Search"> 
< interceptor-ref name="completeStack"/> 
< interceptor-ref name= "execAndWait" > 
<param 

name = "delay "> 1000 </param> 
</interceptor-ref> 

< result 

name= "success" >/Hello.jsp</result> 

< result 

name= "input" >/Index.jsp</result> 
< result name = " wait" >/Wait.jsp</result> 



</action> 



LA PAGINA DI ATTESA 

La pagina di attesa e realizzata in modo che 
dopo 5 secondi provi a rieseguire la action di cui 
l'utente sta attendendo il completamento. Per 
fare ciò viene utilizzato il meta tag "refresh" che 
automaticamente carica un URL dopo un tempo 
predefinito di secondi. L'URL da caricare è forni- 
to tramite il tag "uri" delle tag library struts ed è 
quello utilizzato per l'invocazione della action 
stessa. Si noti che nella pagina sono state intro- 
dotti due nuovi messaggi localizzati: "wait.mes- 
sage" e "wait.reload Message", il primo per 
avvertire l'utente che la action invocata è ancora 
in esecuzione, e il secondo per dare la possibilità 
di ricaricare la pagina nel caso il browser non 
dovesse sopportare il meta tag refresh. Si noti 
come per accedere alla percentuale di progresso 
della action venga usato il tag "property" delle 
tag library Struts 2. Questo è possibile perché 
l'interceptor executeAndWait, come specificato 
nella relativa documentazione, pone la action in 
esecuzione in cima allo StackValue. Lo 
StackValue e una struttura dati a pila che viene 
passata ad ogni pagina e che contiene i bean da 
essa accedibili. Quando ci si riferisce semplice- 
mente ad una property attraverso il suo nome, 
Struts tenta di risolverla tra le proprietà del 
primo oggetto dello stack, che in questo caso è 
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proprio l'action in esecuzione. Il metodo invo- 
cato sarà quindi getProgress(). Per dare un'idea 
della progress bar viene semplicemente estratta 
la percentuale di completamento e attraverso 
un'opportuna moltiplicazione si genera l'imma- 
gine della progress bar come allungamento di 
un singolo pixel verde (per la percentuale ese- 
guita) e di un singolo pixel grigio (per la percen- 
tuale di lavoro ancora da eseguitre). 
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Fig. 3: Far attendere l'utente del sito la generazione 
della pagina con tutti i risultati sarebbe stato contro- 
producente. 



<s:i!8n name = "RealEstate"> 



<html> 



<head> 



<meta http-equiv="Content- 
Type" content="text/html; charset=UTF-8"> 
<meta http-equìv="refresh" 
content='5;url = <s:url includeParams="all"/>'/> 
<title> 

<s:text 
name="site.title"x/s:text> 



</title> 



</head> 



<body> 



<s:text name="wait.message"/> 



<a href='<s:url 
includeParams="aN"/>'><s:text 



name="wait.reloadMessage"/x/a> 



<s:property value="progress" 



/> 



<table align="center" 



border="l"> 



<tr> 



<td> 



<img src="images/pxgreen.gif" height="20" 

width = '<s:property value="300 * progress"/>'> 
<img src="images/pxgrey.gif" height="20" 

width = '<s:property value="300 * 
(1 - progress)"/>'> 

</td> 

</tr> 









</te 


ble> 


</body> 


</html> 


</s: 


Ì18 


n> 







COMPLETARE I FILE 
DI LOCALIZZIAMONE 

Dato che ci sono nuovi messaggi localizzati è 
necessari apportare le opportune modifiche ai 
file di localizzazione. Qui di seguito riportiamo 
la modifica al solo file RealEstate_it.properties 
che contiene le traduzioni italiane. Le stesse 
chiavi andranno aggiunte agli altri due file, quel- 
lo generico e quello inglese. 

wait.message=Ricerca in corso. Attendere. 
wait.reloadMessage=Clicca qui se la pagina non si 

ricarica entro 5 secondi. 



TEST FINALE 
CON UM BROWSER 

Avviate ora l'applicazione web portandovi nella 
directory bin della vostra installazione di Tomcat 
e lanciando il comando "Catalina start". Nel caso 
non abbiate variato nessun parametro rispetto 
ai sorgenti forniti l'applicazione dovrebbe 
rispondere all'URL http://1 27.0.0. 1:8080/realesta- 
te/lndex.jsp . Inserite due valori, minimo e massi- 
mo, compresi tra 100000 euro e 200000 euro, 
visto che tutte le offerte generate sono comun- 
que in questa fascia di prezzo. Premete il pulsan- 
te per avviare la ricerca e ora dovreste visualizza- 
re la progress bar. 



CONCLUSIONI 

Con questo articolo termina questa breve ras- 
segna su Struts2. Abbiamo cercato di mostrare 
attraverso ripetuti sviluppi di un'applicazione 
esemplificativa come applicare alcune tra le 
più interessanti caratteristiche del framework, 
che ovviamente offre numerosissime poten- 
zialità come ad esempio la programmazione 
ed il deploy di nuovi interceptor. Struts2 si 
avvia sicuramente ad essere una piattaforma 
più completa e flessibile della precedente ver- 
sione. Il consiglio è sicuramente quello di par- 
tire con la nuova versione nel caso si debba 
realizzare un nuovo progetto partendo da zero 
e non ci siano quindi problemi di passaggio da 
una tecnologia all'altra 

Daniele De Michelis 
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LA SICUREZZA 
DI WINDOWS XP 

GLI HACKER SONO IN AGGUATO PRONTI A SFRUTTARE QUALSIASI VULNERABILITÀ 
DI WINDOWS XP E DELLE SUE APPLICAZIONI : ECCO PERCHÉ È DI FONDAMENTALE 
IMPORTANZA CONOSCERE IL SISTEMA DI PROTEZIONE CHE MICROSOFT RENDE DISPONIBILE. 



I sistemi operativi Microsoft vengono frequente- 
mente additati a causa della loro scarsa sicurez- 
za e della presunta facilità con cui gli hacker po- 
trebbero forzarne le difese. Se da un lato è innegabi- 
le che spesso vengono rilasciati software con bug di 
security che solo successivamente vengono elimi- 
nati tramite patch, è altrettanto vero che chi ne ha la 
responsabilità, a livello domestico o aziendale, do- 
vrebbe seguire linee guida precise a partire dalla fa- 
se d'installazione e utilizzano cautele tali da evitare 
che malintenzionati siano in grado di attaccarli e ma- 
nipolarli facilmente. Prima di parlare di "software 
good enough", come spesso i detrattori di Microsoft 
sono abituati a fare, bisognerebbe essere certi che gli 
amministratori di sistema siano sufficientemente 
preparati sulla regole della sicurezza ed in grado di 
portare avanti azioni proattive e non solo reattive a dan- 
no avvenuto. 

In effetti, anche se sono state installate tutte le patch 
di sicurezza raccomandate, non è possibile pensare 
di essere al sicuro da possibili attacchi. Gli hacker so- 
no in agguato pronti a sfruttare qualsiasi vulnerabi- 
lità del sistema operativo e delle applicazioni che gi- 
rano al suo interno: ecco perché è di fondamentale im- 
portanza essere informati che il sistema di protezio- 
ne di Windows XP rende disponibili importanti stru- 
menti per analizzare lo stato attuale della sicurezza, 
interpretare i risultati ottenuti e, di conseguenza, ef- 
fettuare le correzioni dovute. 



L'SCM può essere utilizzato da un'applicazione GUI 
che viene eseguita come snap-in all'interno della Mi- 
crosoft Management Console. Tuttavia quando è ne- 
cessario applicare file di configurazione a svariati si- 
stemi è conveniente fare ricorso a secedit.exe, ese- 
guito direttamente sulla linea di comando. 



Area 


Configuratile Items 


Account Policies 


• Password Policy 

• Account Lockout Policy 


Locai Policies 


• Auclit Policy 

• User Rights Assignments 

■ Security Options (Reqistry Values) 


Event Log 


• Settings for System, Application, and 
Security Loqs 


Restricted Groups 


• Group membership 


System Services 


• Startup Modes and Access Control Lists 
for ali system services 


Reqistry 


■ Access Control Lis;s for Reqistry Keys 


File System 


• Access Control Lists for Folders and 
Files 



Figura 1: Aree dove è possibile utilizzare il Security 
Configuration Manager per configurare le impostazio- 
ni relative alla sicurezza 



Tenete presente, tuttavia, che il Security Configu- 
ration Manager non è uno strumento che agisce 
direttamente sulla configurazione attuale del si- 
stema in oggetto, ma serve ad attivare un eserci- 
zio di verifica e di analisi delle impostazioni cor- 
renti rispetto ad uno standard ottimale. Al termine 
di questo esercizio, grazie alle indicazioni ora di- 
sponibili, si potranno applicare i nuovi standard 
di sicurezza, che da quel momento in poi saranno 
validi per il sistema o i sistemi di riferimento. 
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1 
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IL SECURITY 

CONFIGURATION 

MANAGER 

Lo strumento fondamentale per la gestione e l'ana- 
lisi della configurazione della sicurezza è il Security 
Configuration Manager (SCM) > che consiste dei seguenti 
elementi: 

• Modelli di protezione (Security Templates snap- 
in) 

• Analisi e configurazione della protezione (Secu- 
rity Configuration and Analysis snap-in) 

• Secedit.exe 



LA GUI PER IL SECURITY 

CONFIGURATION 

MANAGER 

Il Security Configuration Manager con interfac- 
cia grafica consente ad un amministratore di 
creare e/o editare file di configurazione per la si- 
curezza, eseguire analisi sulla sicurezza, rivede- 
re graficamente i risultati dell'analisi ed appli- 
care una configurazione di sicurezza ad un si- 
stema. Per usufruirne è necessario inserire nel- 
la Microsoft Management Console (MMC) gli 
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RIPRISTINO 

DEL DATABASE 

CORROTTO 

Nel caso sia necessario 

recuperare un 

database di protezione 

corrotto è possibile 

ricorrere alla opzioni 

di disaster recovery di 

Windows. Il metodo di 

ripristino é il 

seguente: all'interno 

del percorso 

%SystemRoot%\securi 

ty\Database digitare 

esentutl Ir ma, se 

avete ancora 

problemi, eseguire 

esenutl con l'opzione 

/p all'interno della 

stessa cartella. 



snap-in Modelli di protezione e Analisi e confi- 
gurazione della protezione. In particolare per 
caricare i citati snap-in all'interno della MMC 
attivare Start-Esegui, digitare mmc nel campo 
Apri e all'interno della console procedere come 
segue: 

• selezionare File-Aggiungi/Rimuovi snap-in e 
fare clic sul pulsante Aggiungi 

• selezionare nella lista Modelli di protezione 
(anche noti come Security templates) e fare 
clic sul pulsante Aggiungi 

• selezionare nella lista Analisi e configurazio- 
ne della protezione e fare clic sul pulsante Ag- 
giungi 

• fare clic sul pulsante Chiudi e poi su OK 




Figura 2: Aggiungere i Modelli di protezione nella 
Microsoft Management Console 



Successivamente è necessario salvare il databa- 
se con le impostazioni effettuate selezionando 
File-Salva con nome e specificando un nome di 
memoria, ad esempio SCMdb.msc. Si noti che il 
file verrà salvato per default nella cartella Strumenti 
di amministrazione dell'utente attualmente log- 
gato e sarà d'ora in poi accessibile all'interno del 
menu Start-Tutti i programmi-Strumenti di am- 
ministrazione. 

L'Analisi e configurazione della protezione si ap- 
poggia ad un database per immagazzinare le ini- 



Analisi protezione sistema 



Analisi ir corso di: 

•t Assegnazione diritti 
utente 

j Gruppi con restrizioni 
•/ Registro di sistema 
■♦ File system 



Servizi sistema 
Criterio di protezione 



■■■■■■■■■■■■■■■■■■■■mi 



Figura 3: Eseguire l'analisi della protezione del siste- 
ma significa effettuare un confronto degli standard 
definiti nei security template con le impostazioni cor- 
renti del sistema, per poi procedere in maniera iterati- 
va fino alla definizione del modello ottimale. 



postazioni e le informazioni necessarie a porta- 
re a termine l'analisi stessa. A questo proposito 
si raccomanda che venga creato un database per 
ogni analisi e configurazione che si vuole porta- 
re a termine. 



ANALIZZARE 
WINDOWS XP 

Una volta eseguiti i passi precedenti è possibile ef- 
fettuare un'analisi approfondita del sistema operativo 
per individuare eventuali falle di sicurezza. Il pro- 
cesso parte da un confronto degli standard definiti 
nei security template con le impostazioni correnti 
del sistema, per poi procedere in maniera iterativa 
fino alla definizione del modello ottimale, guidati da 
ciò che ci viene via via segnalato dalla Microsoft Ma- 
nagement Console. 

In particolare dovete fare un clic destro su Analisi e con- 
figurazione della protezione, selezionare Esegui ana- 
lisi del sistema e premere pulsante OK nella finestra 
di dialogo che identifica il file di log di riferimento 
(percorso C:\Documents and Settings\<utente cor- 
rente>\Documenti\Security\Logs). Al termine del- 
l'analisi dovete entrare negli elementi all'interno di Ana- 
lisi e configurazione della protezione ed esaminare nel 
pannello di destra gli item marcati con una croce ros- 
sa; questi ultimi, infatti, sono quelli che devono essere 
corretti, perché evidenziano deviazioni delle impo- 
stazioni attuali del computer rispetto agli standard 
definiti nel modello di protezione individuato. 
In questa sede è opportuno procedere ad una vera e 
propria analisi degli scostamenti, per determinare 
in maniera certa qual è il delta e determinare il suc- 
cessivo piano di azione. Sebbene il modello di riferi- 
mento sia, in effetti, rigido non è affatto detto che 
tutti gli oggetti evidenziati in rosso portino ad azio- 
ni correttive, la cosa importante è mantenere un tem- 
plate come riferimento e poi definire le tolleranze 
che riteniamo più opportune. In pratica si dovrebbe 
procedere come segue: 
1. Fare doppio clic su Analisi e configurazione della 




Figura 4: Gli elementi segnalati con una croce rossa 
identificano deviazioni delle impostazioni correnti del 
computer rispetto allo standard del template. 
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protezione e poi sugli elementi gerarchicamente 
inferiori, ad esempio Criteri account e, poi, Cri- 
terio password. 

Verificare se sul pannello di destra ci siano og- 
getti segnalati con una croce rossa e analizzare 
se la deviazione delle impostazioni correnti del 
computer rispetto allo standard del template 
sono accettabili oppure no; ad esempio il crite- 
rio "Applica l'unicità delle password memoriz- 
zando le ultime", che consente di creare uno sto- 
rico delle password (valori da 1 a 24) per evita- 
re che vengano digitate sempre le stesse, può 
segnalare un scostamento tra le impostazioni 
del template (ad esempio 20) e quelle attuali del 
computer (ad esempio 10). 
Ora che abbiamo i dati per procedere dobbiamo 
fare doppio clic sul criterio che stiamo esami- 
nando, per poi scegliere o di escludere questo 
criterio dal database, togliendo il segno di spun- 
ta dalla check box "Definisci il criterio nel data- 
base", oppure d'identificare il numero delle pas- 
sword da conservare, accettando il valore 20 
proposto dal modello o un altro valore com- 
preso nell'intervallo di tolleranza. Se nell'e- 
sempio proposto venisse impostato, ad esempio, 

10 scomparirebbe subito la croce rossa. 

11 punto tre deve essere ripetuto per tutti gli og- 
getti segnalati con una croce rossa. 
Bisogna, poi, salvare le impostazioni correnti 
(File-Salva o File-Salva con nome se si vuole 
mantenere traccia dei valori iniziali) . 

Infine fare clic destro su Analisi e configurazio- 
ne della protezione e scegliere Esporta model- 
lo per creare il "nostro" modello .inf. 



^ Criteri Computer locale 

^ Configurazione computer 
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- _a} Criteri account 

■ +' f§ Criterio di blocco account 

+ LJJ Criteri locali 
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Figura 5: 1 cambiamenti eseguiti sulle policy locali 
vengono automaticamente inserite nel database loca- 
le delle policy e possono essere verificati direttamen- 
ti nella console Criteri di gruppo. 



SIGNIFICATO 
DEI MODELLI 
DI PROTEZIONE 

I Modelli di protezione sono file che contengono 
un set di configurazione di sicurezza e fornisco- 
no un modo semplice per standardizzare la si- 



curezza all'interno di un singolo sistema o di un 
dominio. Possono essere applicati a computer 
basati su Windows XP importandoli in una Group 
Policy oppure applicandoli direttamente sul com- 
puter locale tramite SCM. I Modelli di protezio- 
ne includono un set di file predefiniti *.inf che 
possono essere utilizzati dal System Admini- 
strator. Il loro percorso di default è %System- 
Root%\ security \templates (solitamente C:\WIN- 
DOWS\ security \templates) ed hanno un significato 
ben preciso. In particolare Setup security.inf con- 
tiene le impostazioni predefinite di sicurezza che 
vengono applicate durante l'installazione del si- 
stema operativo, compresi i permessi sui file del- 
la system root. Questo template viene utilizzato 
per propositi di disaster recovery e non dovreb- 
be mai essere applicato tramite group policy. 
Compatws.inf è utilizzato per modificare le au- 
torizzazioni predefinite di accesso ai file e al re- 
gistro di Windows concesse al gruppo Users in 
maniera tale che siano conformi ai requisiti del- 
le principali applicazioni non certificate. 
Rootsec.inf è il cosiddetto modello di protezione 
della directory principale di sistema. Esso, in- 
fatti, definisce i nuovi permessi della system root 
introdotti da Windows XP Professional e può es- 
sere utilizzato per eseguire nuovamente i per- 
messi di accesso alla directory principale nel ca- 
so siano stati cambiati inavvertitamente. 
I restanti modelli di default si possono raggrup- 
pare nelle seguenti categorie: 

1. Modelli protetti, ossia i secur*.inf, che definisco- 
no impostazioni di protezione avanzate, ad esem- 
pio per le password (essenzialmente securedc.inf 
esecurews.inf). 

2. Modelli a protezione avanzata, ossia gli hisec*.inf, 
che impongono ulteriori restrizioni crittografiche 
e di firma richieste per l'autenticazione e per i da- 
ti trasmessi sui canali protetti (essenzialmente hi- 
secdc.inf e hisecws.inf). 
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MODIFICA 
E BACKUP 
DEL FILE .IMF 

I Modelli di protezione 
possono essere 
modificati a nostro 
piacimento; in questo 
modo è possibile 
personalizzare le 
policy di sicurezza che 
si vogliono applicare 
nei nostri sistemi. 
Tuttavia è 
fondamentale 
sottolineare che prima 
di effettuare qualsiasi 
modifica è necessario 
procedere al 
salvataggio del file 
.inf originario. 



Figura 6: Nella console gpedit.msc, questa volta con- 
trolliamo gli aggiornamenti delle Opzioni di protezione 
all'interno dei Criteri locali. 
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SCHEMI 
DI PATCHIMG 

È importante essere a 

conoscenza che 

Microsoft utilizza i tre 

diversi schemi di 

patchìng (Service Pach, 

Hotfixes e Hotf ix Roll- 

ups) non solo per i 

sistemi operativi, ma 

anche per le 

applicazioni. Quindi è 

sicuramente possibile 

che nonostante siano 

state seguite tutte le 

linee guide relative 

alla sicurezza e 

installate tutte le 

ultime patch del 

sistema operativo, 

Windows XP sia 

ancora vulnerabile. In 

altri termini un hacker 

potrebbe sfruttare 

debolezze presenti in 

alcune applicazioni per 

manomettere il 

sistema operativo 

stesso. 



LE IMPOSTAZIONI 
DI SICUREZZA 
INDIVIDUATE 

L'esercizio precedente ci ha portato a creare un 
modello di protezione che riteniamo il più oppor- 
tuno per la nostra piattaforma. Ricordiamo che fi- 
no ad ora abbiamo lavorato esclusivamente per 
creare il modello di riferimento, ma che non lo ab- 
biamo ancora reso effettivo. Ora è venuto il mo- 
mento di farlo. Di fatto quello che accadrà è una 
modifica di un certo numero di chiavi del registro 
di configurazione, che bisogna ovviamente salva- 
re in anticipo. 

Per applicare i setting di sicurezza dobbiamo pro- 
cedere all'interno del pannello di sinistra della 
MMC come indicato di seguito: 



1. 



6. 



Fare clic destro su Analisi e configurazione del- 
la protezione. 

Selezionare dal menu a comparsa Configura il 
computer ora. 

Definire il file di log di riferimento, ad esempio: 
%SystemRoot%\security\logs\Mysecure.log 
Fare clic sul pulsante OK. 
Fare poi clic su Chiudi e salvare le impostazio- 
ni della MMC, indicando il nome del file da sal- 
vare (ad es. SCMdb). 
Eseguire il riavvio del sistema. 



Una volta terminato il reboot di Windows tutte le re- 
gole definite nel security database saranno state 
applicate al sistema di riferimento. 



VERIFICARE 
GLI EFFETTI 

I cambiamenti eseguiti sulle policy locali vengono 
automaticamente inserite nel database locale 
delle policy. I riscontri che eseguiamo di segui- 
to necessitano di diritti amministrativi. 
Per verificare le nuove impostazioni lanciare da 
Start-Esegui il programma gpedit.msc, Criteri 
di gruppo. 

Possiamo andare ora a ricercare una policy che 
abbiamo modificato tramite Microsoft Mana- 
gement Console, ad esempio quella relativa al- 
la storicizzazione delle password. Espandiamo, 
quindi, Configurazione computer, Impostazio- 
ni di Windows, Impostazioni protezione ed, in- 
fine, Criteri account. Ora facciamo clic su Criterio 
password e a destra possiamo osservare le im- 
postazioni che volevamo verificare. Se, poi, nel 
pannello di sinistra espandiamo Criteri locali e 
facciamo clic su Opzioni di protezione possia- 
mo controllare a destra le ulteriori impostazio- 
ni di protezione. 



LO STRUMENTO 
SCM PER LINEA 
DI COMANDO 

Eseguire la Security Management Console da li- 
nea di comando significa lanciare l'utility sece- 
dit.exe che, non disponendo d'interfaccia grafica, 
ha evidenti limitazioni. Ovviamente è necessario av- 
viare l'utility da Start-Esegui dopo aver digitato 
cmd per avviare il prompt dei comandi di Windows 
XP e, poi, secedit. In particolare alcune funziona- 
lità fornite dal comando sono riportate di seguito. 
L'utilità di eseguire SCM da linea di comando de- 
ve essere ricercata nella possibilità d'inserire que- 
sto comando in uno script amministrativo per ma- 
nipolare dinamicamente il sistema. 
In particolare secedit/analyze consente di esegui- 
re i task di analisi del sistema. L'opzione /analyze 
è utile ad analizzare la protezione di un sistema 
confrontandola con le impostazioni di base archi- 
viate in un database. Nel comando bisogna sempre 
specificare il nome del database di riferimento, il no- 
me del security template .inf e il nome del file che 
conterrà i risultati dell'analisi. Nel caso in cui que- 
st'ultimo non venisse specificato é necessario con- 
sultare il log di default scesrv.log presente in %Sy- 
stemRoot%\security\logs. 

L'opzione secedit /configure consente, invece, di 
configurare la protezione del computer in base a 
quanto specificato nel database di riferimento. An- 
che in questo caso bisogna specificare database e 
modello di protezione. 

secedit /export e secedit /import sono opzioni di 
esportazione ed importazione delle impostazioni 
di protezione indicate nel database. Un utilizzo 
pratico è la possibilità, ad esempio, d'importare 
determinati security template nel database cor- 
rente in maniera tale che le impostazioni definite 
nel modello possano essere subito applicate o, co- 
munque, prima analizzate. Nell'esempio che se- 
gue vengono importate nel database myDB.sdb le 
impostazioni di protezione presenti nel file your- 
Sec.inf. 

secedit /import /db myDB.sdb /cfg yourSec.inf / 
overwrite 

L'opzione overwrite indica che il database deve es- 
sere svuotato prima di applicare il template. Nel 
caso in cui /overwrite non venga specificato, le 
nuove impostazione andranno in append nel da- 
tabase ed, in caso di conflitto, i setting del nuovo mo- 
dello avranno la precedenza. 
Infine esiste anche la possibilità di validare la sin- 
tassi di un modello di protezione che si desidera 
importare nel database con la secedit /validate se- 
guita dal nome del file. In questo caso è possibile crea- 
re un modello di ripristino con l'opzione /Gene- 
rateRollback. Tale modello potrà essere utilizzato 
per ripristinare i security setting presenti prima 
dell'applicazione del nuovo template. 
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DISASTER RECOVERY 
DI DATABASE 

Nel caso in cui, in seguito ad un arresto non cor- 
retto del PC, il database di protezione si sia dan- 
neggiato si può eseguire un controllo d'inte- 
grità tramite l'utility esentutl. Si tratta di posi- 
zionarsi nel percorso %SystemRoot%\secu- 
rity\Database e di digitare esentutl /g sece- 
dit.sdb. Una volta ultimata l'analisi verrà evi- 
denziato un report nello stesso percorso chiamato 
secedit.INTEG.RAW e verificabile con Notepad 
o direttamente col comando type seguito dal 
pipe (|) e da more. Per procedere al recovery di 
un database danneggiato rendendolo di nuovo 
consistente, digitare esentutl /r nella cartella 
%SystemRoot%\ security. Se questa operazione 
non ha avuto successo per ripararlo utilizzare 
esentutl /p nella cartella %SystemRoot%\ secu- 
rity \ Database. 

Ricordarsi, infine, di cancellare i file di log crea- 
ti in %SystemRoot%\security. 
Nel caso siano necessarie ulteriori informazio- 
ni digitare esentutl /? per visualizzare la guida in 
linea con tutte le opzioni disponibili. 




Figura 7: Le opzioni dettagliate dell'utility esentutl 
che consente di ripristinare un database corrotto. 



ALCUNE 

RACCOMANDAZIONI 
DA niOM TRASCURARE 

Al fine di fissare i buchi di sicurezza che vengono via 
via individuati da Microsoft è importante installare tut- 
te le patch disponibili e, magari, abilitare sul PC l'ag- 
giornamento automatico da Internet. A questo pro- 
posito è necessario sapere che Microsoft fornisce tre 
metodi di aggiornamento del sistema operativo. Il 
primo è quello basato sui Service Pack. Si tratta dei co- 
siddetti "Major Operating System updates", che in- 
cludono tutte le patch più importanti e meno im- 
portanti rilasciate fino a quel momento. Sono alta- 
mente affidabili, in quanto testati accuratamente da 
Microsoft prima del rilascio. Il Service Pack attual- 
mente disponibile per Windows XP è il SP2 
(http://www.microsoft.com/windowsxp/sp2/de- 
fault.mspx). Il secondo metodo è quello che utilizza 
gli Hotfixes. Tra un rilascio di un Service Pack ed un 
altro vengono distribuiti aggiornamenti intermedi 
chiamati, appunto, hotfixes. Si tratta solitamente di 
piccole patch che si occupano di casi specifici. Ve- 
nendo rilasciati velocemente per risolvere problemi 
particolari, ma non sono testati accuratamente come 
i Service Pack. Infine esistono i cosiddetti Hotfix Roll- 
ups. Si tratta di una via di mezzo tra i due preceden- 
ti metodi di update. Non sono corposi come i Servi- 
ce Pack, ma contengono, in ogni caso, più di una pat- 
ch, essendo dedicati alla risoluzione di più proble- 
mi. Oltre a quanto detto in precedenza è possibile 
aggiornare il nostro sistema operativo anche in un 
altro modo. È infatti possibile ottenere il supporto di 
Microsoft facendo il download automatico delle pat- 
ch critiche di Windows XP accedendo al sito 
http://www.windowsupdate.com. 
Non appena si è connessi al sito Web, Windows Up- 
date effettua lo scan del computer corrente per vi- 
sualizzare, successivamente, un report che evidenzia 
le patch necessarie software e hardware. E' necessario, 
poi, scegliere gli update che si vogliono installare e co- 
me installarli. 
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Figura 8: Dopo avere eseguito l'utility esentutl 
con opzione g viene generato un report chiamato 
secedit.INTEG.RAW 




Figura 9: Windows Security Center dà una grossa 
mano ad identificare lo status attuale della sicurezza 
e ad impostare i setting di security. 
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CREIAMO UN VISTA 
PERSONALIZZATO 

ALLA SCOPERTA DELLO STRUMENTO PENSATO DA MICROSOFT PER CREARE E DISTRIBUIRE 
IL SISTEMA OPERATIVO WINDOWS VISTA PERSONALIZZANDOLO CON LE IMPOSTAZIONI E 
IL SOFTWARE PIÙ ADATTO PER LE PROPRIE ESIGENZE 




wi 




— Conoscenze base di 
LU, Windows e della riga 
di comando 



Windows XP Service 
Pack 2, Windows 
Server 2003 o 
Windows Vista - .NET 
Framework 2.0, due 
computer distinti 



^a^c^i 



Tempo di realizzazione 



000 00 



r AIK ovvero Windows Automated In- 
stallation Kit. Detto in parole semplici, 
WAIK è un kit composto da tool e docu- 
mentazione che consente la distribuzione del siste- 
ma operativo Windows su più computer in maniera 
automatica. Sapere utilizzare questo strumento ci 
permette di accelerare notevolmente i tempi di di- 
stribuzione del software ogni qualvolta questo si ren- 
desse necessario per un rinnovo del parco macchine 
o anche solo per l'applicazione di aggiornamenti e 
Service Pack. Dal rilascio di Windows Vista è ora 
disponibile un nuovo strumento: WAIK che final- 
mente offre a tutti la possibilità di creare un am- 
biente di distribuzione del nuovo sistema opera- 
tivo Windows Vista. Il kit WAIK contiene oltre ad 
una nutrita documentazione su ciascun tool, i se- 
guenti strumenti: Windows PE 2.0, ImageX, Win- 
dows System Image Manager, Windows Deployment 
Services 



LA COMPOSIZIONE 
DEL KIT 

Windows PE2.0b la nuova versione di Windows 
Preinstallation Environment, un ambiente realiz- 
zato specificatamente per consentire la prepara- 
zione di un computer nuovo per l'installazione di 
Windows Vista. In pratica Windows PE 2.0 è un mi- 
ni sistema operativo (su base Windows Vista), es- 
senziale e limitato, che permette unicamente di 
avviare un nuovo PC sprovvisto di sistema opera- 
tivo e permetterne l'installazione attraverso un'im- 
magine presente su disco locale o su una condivi- 
sione di rete. Chiunque abbia già installato Win- 
dows Vista, in realtà ha già conosciuto Windows 
PE 2.0 in quanto l'interfaccia grafica che permet- 
te l'installazione e la configurazione divista è pro- 
prio Windows PE 2.0 in azione. 
ImageXè un tool da riga di comando che permet- 
te di creare e gestire le immagini di distribuzione di 
Windows con estensione WIM. In pratica questo 
tool permette di acquisire l'intero contenuto di 
una partizione del disco, comprimerla e racchiuderla 



all'interno di un file immagine avente estensione 
.WIM che potrà poi essere utilizzato in un secon- 
do momento per ricreare la medesima partizione 
su un computer differente e producendo di con- 
seguenza un clone del sistema. Questa operazione 
viene denominata applicazione dell'immagine ed 
è l'operazione speculare all'acquisizione. I comandi 
principali di ImageX sono: 

• IMAGEX /CAPTURE 

Acquisisce l'immagine di una partizione o di una 
directory e la inserisce in un file WIM. 

• IMAGEX /APPLY 

Applica un'immagine ad una partizione prece- 
dentemente formattata. 

• IMAGEX /INFO 

Visualizza informazioni su un'immagine o su un 
file WIM. 

• IMAGEX /SPLIT 

Divide un file WIM in più file SWM di dimensioni 
minori affinché questi possano essere inseriti su 
più supporti (CD o DVD). 




Figura 1: ImageX nel Prompt dei comandi degli stru- 
menti di Windows PE 



Windows System Image Manager è un tool grafico 
grazie al quale è possibile gestire più efficacemente 
e soprattutto visualmente le immagini create con 
ImageX. Con Windows System Image Manager pos- 
siamo modificare il contenuto dei file immagine ag- 
giungendo o rimuovendo componenti e service pack 
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modificando il file di risposte Unattend.xml. Que- 
sto file, molto importante, contiene in pratica tutte quel- 
le configurazioni iniziali da applicare all'installazio- 
ne del sistema operativo quali ad esempio la confi- 
gurazione del disco, le impostazioni di rete, le impo- 
stazioni internazionali, e così via. Windows System 
Image Manager permette quindi principalmente di 
gestire questo file che sarebbe molto difficoltoso se non 
impossibile da editare a mano in quanto in formato 
XML ed abbastanza complesso. 

1 Windows Deployment Services, che sostituiscono 
i vecchi Remote Installation Services, sono infine 
un insieme di servizi che permettono di installa- 
re nuovi PC da remoto tramite rete senza la ne- 
cessità di essere fisicamente presenti dinanzi ad 
essi. Con i Windows Deployment Services è quin- 
di possibile ad esempio riavviare una macchina da 
remoto e installare il sistema operativo senza uti- 
lizzare localmente il CD o il DVD dello stesso. Que- 
sti servizi sono stati rilasciati con la Service Pack 2 
di Windows Server 2003 ma sono anche disponi- 
bili in WAIK e permettono di installare uno qualsiasi 
dei sistemi operativi Windows, non necessaria- 
mente Windows Vista. IWindows Deployment Ser- 
vices sono in realtà composti da tre categorie di- 
stinte di strumenti: 

- Componenti Server 

che comprendono un server PXE (Pre-Boot Exe- 
cution Environment) e un server TFTP (Trivial Fi- 
le Transfer Protocol) 

- Componenti Client 

rappresentati da una GUI che girando in Windows 
PE permette di comunicare con i componenti ser- 
ver per installare il sistema operativo. 

- Componenti di Amministrazione 
costituiti da un insieme di tool necessari per la ge- 
stione del server, delle immagini del sistema ope- 
rativo e degli account utente. 

Essendo servizi server, i Windows Deployment Services 
possono essere installati solo su Windows Server 2003 
con almeno la Service Pack 1 installata. 



IL FORMATO 

IMMAGINE WIM 

Non stiamo parlando di un nuovo formato immagi- 
ne visuale, bensì del nuovo formato utilizzato per la 



distribuzione dei sistemi operativi Microsoft a parti- 
re dal rilascio di Windows Vista. Windows Image o 
WIM, ha tutta una nuova serie di caratteristiche che 
lo rendono realmente innovativo rispetto alle pre- 
cedenti soluzioni basate su file CAB (il quale viene 
spesso designato come il padre di WIM) . Innanzi tut- 
to WIM è un formato di distribuzione indipendente 
dall'hardware della macchina su cui il sistema viene 
installato. L'unica differenza presente è quella tra si- 
stemi a 32 o a 64 bit per i quali devono essere utiliz- 
zati due file WIM differenti. Mentre per tutte le altre 
configurazioni il file WIM da utilizzare resta lo stes- 
so. Inoltre WIM può essere utilizzato per eseguire 
un'installazione di aggiornamento o di recovery del 
sistema operativo, quindi un'installazione non ne- 
cessariamente distruttiva. Il team di sviluppo Mi- 
crosoft ha inoltre cercato di migliorare ulteriormen- 
te la compressione delle immagini di distribuzione con- 
tenute nei file WIM arrivando ad un compromesso 
tra prestazioni e livello di compressione delle im- 
magini che ora è pressoché ottimale. Ma cos'è fisi- 
camente un file WIM? Un file WIM è un unico file che 
racchiude in se una o più immagini contenenti tutti 
i file necessari all'installazione di un sistema opera- 
tivo Microsoft e comprendente: 

• Un'intestazione, nella quale troviamo la firma del 
file WIM, la sua versione, la dimensione, un GUID 
(identificativo univoco) e un numero di parte, ov- 
vero uno SplitNumber utilizzato nel momento in 
cui file WIM viene fisicamente diviso su più sup- 
porti(CDoDVD). 

• Dei metadati, uno per ogni immagine contenuta 
nel file WIM, che contengono informazioni rela- 
tive ai file contenuti in ciascuna immagine quali even- 
tuali permessi sui file, attributi, ecc. 

• Una tabella risorse contenente gli HASH dei file 
ed utilizzata per la loro indicizzazione e rapido 
accesso. 

• Contenuto XML vario per la descrizione del file 
nel suo complesso. 

È da notare che un file WIM può contenere diverse 
immagini relative a diversi sistemi operativi. Ad esem- 
pio uno stesso file WIM potrebbe contenere l'imma- 
gine di un'installazione di Windows XP Professional 
e di Windows XP Home. In questo caso la novità con- 
siste nel fatto che tutti i file uguali tra le due versioni 



ATTENZIONE ALLA VERSIONE DI WINDOWS 



Windows AIK può 
essere installato solo 
su Windows XP 
Service Pack 2, 
Windows Server 2003 
o Windows Vista. 



Inoltre Windows AIK 
attualmente non 
supporta 

l'installazione su un 
sistema operativo 
con una lingua 



differente dalla 
propria. Per questo 
motivo è opportuno 
installare WAIK nella 
stessa lingua del 
sistema operativo in 



cui verrà eseguito. 
Se si dispone quindi 
di Windows in 
italiano, andrà 
installato WAIK in 
versione italiana. 




DOVE 

TROVARE 

WAIK 

La versione italiana di 

Windows Automated 

Installation Kit (AIK) è 

disponibile 

all'indirizzo: 

http://www.microsoft. 

com/downloads/details. 

aspx?familyid=C7D4BC6D 

-15F3-4284-91 23-679830 

D629F2&displavlanq=it 



Scegliete con 
attenzione la lingua 
del kit in modo tale da 
farla corrispondere 
alla lingua della vostra 
versione di Windows. 
Se possedete Windows 
XP in versione inglese, 
scaricate WAIK in 
questa lingua. 



I TOOL DI 
LETTURA 
FILE ISO 

I tool di lettura file ISO 
sono degli applicativi 
che permettono di 
leggere i file 
immagine con 
estensione .ISO, .IMG, 
.NRG ecc, e renderli 
disponibili al sistema 
operativo come se 
fossero a tutti gli 
effetti dei lettori CD- 
ROM o DVD-ROM fisici. 
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' non vengono duplicati ma dello stesso file ne trovia- 
mo una sola istanza che verrà utilizzata di volta in 
volta per installare l'uno o l'altro sistema operativo. 
In questo modo l'aumento di dimensioni dovuto al- 
la presenza contemporanea di due installazioni nel- 
lo stesso file di distribuzione corrisponderà solo alla 
somma delle dimensioni dei file diversi tra le due ver- 
sioni di sistema operativo. 



INSTALLAZIONE 

Ora che sappiamo cos'èWAIK, possiamo passare al- 
la sua installazione. Procuriamoci WAIK che viene 
distribuito sotto forma di file .IMG e poi con l'ausilio 
di un tool di lettura immagini ISO (quale ad esem- 
pio i DAEMON Tools o Virtual CD) montiamo l'im- 
magine ed accediamo al disco di WAIK. In alternati- 
va possiamo anche masterizzare un CD-ROM per un 
utilizzo più pratico. Montata l'immagine, il menu au- 
tostart di WAIK ci mostrerà una serie di utili link at- 
traverso i quali possiamo accedere ai diversi conte- 
nuti del disco: 




Windows Automated Installatici Kit (Windows AIK) consente di 
preinstallare, personalizzare e distribuire i prodotti Windows Vista. 



Per eseguire Windows AIK, nel computer di riferimento deve essere 
installato Windows XP Professional con Service Pack 2, Windows 
Server 2003 con Service Pack 1 o Windows Vista. 



Figura 2: II menu di avvio di WAIK 



I MAC EX 

Per informazioni 

dettagliate sulle 

opzioni della linea di 

comando di ImageX 

oltre a leggere la 

documentazione 

fornita a corredo di 

WAIK, possiamo anche 

consultare il seguente 

indirizzo internet: 

http://technet2.micros 

oft.com/WindowsVista 

/en/library/bb068119- 

1ba6-48c7-9ad7- 

3ed3f72592e91033.ms 

px?mfr=true 



Clicchiamo quindi sul link Installazione dì Windows 
AIK e procediamo con l'installazione che non ri- 
chiede alcuna informazione particolare se non le ti- 
piche domande dei wizard di setup (accettazione li- 
cenza, percorso di installazione, ecc). Al termine del 
setup troveremo nel menu Avvio il nuovo gruppo Mi- 
crosoft Windows AIK: 



1 §4. Windows Live Messenger 


Ql |)^j Documentata! 


> 




.■■.'..■I'., ! ' .■.■.■.. 


sPE 




Windows System Image Manager 





Figura 3: WAIK nel menu Avvio 



Nel sotto menu Documentation troviamo tutta la 
nutrita documentazione ufficiale (fortunatamente 
in italiano) disponibile per WAIK che ci tornerà mol- 



to utile per comprendere i diversi passaggi implica- 
ti nella creazione di un ambiente di distribuzione 
funzionale. 



CREAZIONE 

DI UHI AMBIENTE 

DI DISTRIBUZIONE 

Siamo giunti quindi al momento clou della nostra 
conoscenza con WAIK. Ora vedremo come creare 
praticamente una procedura di distribuzione che 
ci porterà ad ottenere un'immagine di Windows 
Vista che potrà essere distribuita su molteplici 
computer. La procedura che stiamo per vedere è 
una simulazione e pertanto, sebbene in realtà i 
computer coinvolti in un processo di distribuzio- 
ne reale siano diversi, nel nostro caso faremo uso 
di due soli computer, l'uno sul quale installeremo 
WAIK (il computer di lavoro) ed un secondo com- 
puter nel quale installeremo la nostra immagine 
del sistema operativo e che utilizzeremo anche co- 
me computer dal quale ricavare l'immagine WIM 
(il computer di destinazione). 

Quello di cui avremo bisogno sarà quindi: 

- Il DVD di Windows Vista o comunque una sua im- 
magine ISO 

- Un secondo PC, connesso in rete con il compu- 
ter di lavoro 

- WAIK installato sul computer di lavoro 

Per prima cosa, dobbiamo creare un nuovo file di ri- 
sposte, ovvero quel file (Unattend.xml) che defini- 
sce tutte le impostazioni del sistema operativo che 
verrà installato. Per creare un file di risposte dobbia- 
mo avviare Windows System Image Editor dal grup- 
po di programmi Microsoft Windows AIK del menu 
Avvio. 




Figura 4: Windows System Image Editor 

Seguiamo quindi i seguenti passaggi: 

- Inserire il DVD di Windows Vista nel lettore DVD. 
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- Copiare il file ins tall.wim dalla cartella sources del 
DVD divista in una cartella qualsiasi del compu- 
ter di lavoro. 

- In Windows System Image Editor scegliere Seleziona 
immagine di Windows... nel menu File. 

- Selezionare quindi il file install.wim preceden- 
temente copiato dal DVD di Windows Vista. 

- Dalla finestra di dialogo che apparirà, seleziona- 
re l'immagine della versione di Windows Vista che 
si intende utilizzare e quindi premere OK. 

A questo punto possiamo scegliere la voce Nuovo fi- 
le di risposta... dal menu File. Apparirà un mes- 
saggio che ci informerà del fatto che non esiste ancora 
un file di catalogo: 



\".:.'K:à ■!> aprir? 
Impossibile trovar 
Per continuare è 


■ : ■ ' vv'iiv .: . ; liti 
\ .■■:.-■ ■ . n ■ iS'dciflJ ! :. ■ ..■■■'■ ■ :■:. ■ìowì 

■■■:..".! : i ■■■/!■.■ ,. .,. 

re un amministratore del computer locale.] 


:e:\:.\~rh~ 


I* , || 


No 



Figura 5: Avviso di creazione nuovo file catalogo 



Premiamo OK affinché questo file venga creato. An- 
diamo ora nel riquadro Immagine di Windows ed 
espandiamo il nodo Componenti. Qui vediamo tut- 
ti i componenti che possiamo includere / escludere 
dalla nostra immagine e che possiamo personaliz- 
zare tramite il file di risposte. Per un'installazione 
standard aggiungiamo i seguenti componenti clic- 
cando con il tasto destro su di essi e selezionando il 
passaggio di configurazione specificato: 

• Microsoft-Windows-Setup\DiskConfigura- 
tion\ Disk\ CreatePartitions \ CreatePartition 
(Passaggio 1 windowsPE) 

• Microsoft-Windows-Setup\DiskConfigura- 
tion\Disk\ModifyPartitions\ModifyPartition 
(Passaggio 1 windowsPE) 

• Microsoft- Windows - Setup \ Imagelnstall \ OSIma- 
geUnstallTo 

(Passaggio 1 windowsPE) 

• Microsoft-Windows-Setup\UserData 
(Passaggio 1 windowsPE) 

• Microsoft-Windows-International-Core-WinPE 
(Passaggio 1 windowsPE) 

• Microsoft-Windows-Shell-Setup\OEMInforma- 
tion 

(Passaggio 4 specialize) 

• Microsoft-Windows-Shell-Setup\OOBE 
(Passaggio 7 oobeSystem) 

• Microsoft-Windows-Shell-Setup\AutoLogon 
(Passaggio 7 oobeSystem) 

Al termine dell'aggiunta dei componenti, nel riqua- 
dro File di risposta dovremmo vedere i componen- 
ti appena aggiunti. Ora è necessario configurare cia- 



scun componente impostandone le proprietà come 
indicato di seguito: 

• Microsoft- Windows-International-Core-WinPE 
[InputLocale=it-IT, SystemLocale=it-IT, UI- 
Language=it-IT, UserLocale=it-IT] 

• Microsoft-Windows-International-Core-Win- 
PE \ SetupUILanguage 
[UILanguage=it-IT] 

• Microsoft- Windows-Setup\DiskConfiguration 
[WillShowUI=OnError] 

• Microsoft- Windows-Setup\DiskConfigura- 
tion\Disk 

[DiskID=0, WillWipeDisk=true] 

• Microsoft- Windows-Setup\DiskConfigura- 
tion\Disk\CreatePartitions\CreatePartition 
[Extend=false, Order=l, Size=15000, Type=Pri- 
mary] 

• Microsoft- Windows-Setup\DiskConfigura- 
tion\Disk\ModifyPartitions\ModifyPartition 
[Active=true, Extend=false, Format=NTFS, La- 
bel=OS_Install, Letter=C, Order=l, Partitio- 
nID=l] 

• Microsoft- Windows- Setup \ Imagelnstall\ OSI- 
mage 

[WillShowUI=OnError] 

• Microsoft- Windows- Setup \ Imagelnstall\ OSI- 
mageUnstallTo 

[DiskID=0, PartitionID=l] 

• Microsoft- Windows-Setup\UserData 
[AcceptEula=true] 

• Microsoft- Windows- Setup \ UserData\ ProductKey 
[Key=<Windows Product Key>, WillShowUI=OnEr- 
ror] 

• Microsoft- Windows-Shell-Setup\OEMInforma- 
tion 

[Manufacturer=<produttore>, HelpCustomi- 
zed=false] 

• Microsoft- Windows-Shell-Setup\OOBE 
[HideEULAPage=true, ProtectYourPC=3, Skip- 
MachineOOBE=true, SkipUserOOBE=true, 
NetworkLocation=Work] 

• Microsoft- Windows-Shell-Setup\Auto Logon 
[Enabled=true, LogonCount=5, Username=Ad- 
ministrator] 

• Microsoft- Windows-Shell-Setup\AutoLo- 
gon\Password 

[<password amministratoro] 

Terminata l'aggiunta e la configurazione dei com- 
ponenti, possiamo finalmente validare e salvare il 
nostro nuovo file di risposte, selezionando prima la 
voce Convalida file di risposta dal menu Strumen- 
ti e poi, in caso di esito positivo, Salva file di rispo- 
sta dal menu File dando come nome al nostro file di 
risposte Autounaltend.xml e posizionando lo stes- 
so su una chiave di memoria USB (vedremo in se- 
guito il motivo di questa operazione). 




I WINDOWS 

DEPLOYMENT 

SERVICES 

I Windows 

Deployment Services 
non sono installati 
automaticamente 
insieme a WAIK ma 
devono essere 
installati 
esplicitamente 
eseguendo il file 
windows-deployment- 
services-update- 
x86.exe o il file 
windows-deployment- 
services-update- 
amd64.exe (in base 
alla tipologia del 
proprio processore) 
presenti nel percorso 
<root>:\WDS del CD di 
WAIK. 



WEB 
REFERENCE 

Informazioni generali 
sulle tecnologie di 
deployment di 
Microsoft: 

http://www.microsoft. 

com/technet/desktop 

deployment/default.mspx 
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Siamo arrivati quindi all'installazione di Windows 
sul secondo PC, quello di destinazione. Inseriamo 
la chiave di memoria USB in una porta USB libera 
del computer ed installiamo Windows Vista dal suo 
DVD. Per impostazione predefinita, il setup di Win- 
dows Vista cerca in tutte le unità rimovibili un file 
Autounattend.xml avendo posizionato il nostro fi- 
le Autounattend.xml sulla chiave di memoria USB, 
l'installazione di Windows Vista lo troverà e lo uti- 
lizzerà per avviare l'installazione sulla base delle 
impostazioni da noi effettuate con Windows Sy- 
stem Image Editor. Al termine dell'installazione 
del sistema operativo dobbiamo preparare il com- 
puter alla generazione dell'immagine di distribu- 
zione e quindi per fare questo eseguiamo dal prompt 
dei comandi Sysprep: 

c:\windows\system32\sysprep\sysprep.exe /oobe 

/generalize /shutdown 

Al termine della preparazione, Sysprep effettuerà lo 
shutdown del sistema che ora è pronto per essere ac- 
quisito come immagine. Per acquisire un'immagine 
del sistema con ImageX, utilizziamo l'ambiente Win- 
dows PE. Dobbiamo quindi creare un disco di avvio 
di Windows PE 2.0 seguendo questi semplici passaggi 
sul computer di lavoro: 

- Eseguire al prompt dei comandi degli strumenti di 
Windows PE: 

copype x86 c:\winpe 

- Copiare imagex: 

copy "c:\programmi\Windows 

AIK\Tools\x86\imagex.exe" c:\winpe\iso\ 

- Creare un file di immagine ISO di Windows PE con 
il comando: 

oscdimg -n -bc:\winpe\etfsboot.com c:\winpe\ISO 

c:\winpe\winpe.iso 

Possiamo ora masterizzare un CD-ROM con l'im- 
magine ISO di Windows PE ed utilizzarlo per avviare 
il computer di destinazione affinché parta dal CD di 
Windows PE (nel caso il computer non fosse configurato 
per partire da CD-ROM, modificare opportunamente 
la sequenza di avvio nel BIOS della macchina). Al ter- 
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Figura 6: Console di comando di Windows PE 2.0 



mine della procedura di avvio vedremo apparire la 
console a riga di comando di Windows PE. 
Procediamo quindi con l'acquisizione dell'immagi- 
ne del computer di destinazione digitando al prompt 
dei comandi di Windows PE il seguente comando: 

d:\imagex /compress fast /capture e: c:\winimg.wim 
"Windows Vista Installation" /verify 

Ottenuta l'immagine winimg.wim possiamo ora co- 
modamente copiarla sul nostro computer di lavoro 
in una condivisione di rete in modo tale da renderla 
disponibile per l'applicazione su altri computer. 



LA DISTRIBUZIONE 

Possiamo ora a scopo di test formattare totalmente il 
computer di destinazione che abbiamo utilizzato per 
generare l'immagine di distribuzione. Effettuata la 
formattazione, inseriamo nel computer il CDROM 
di Windows PE generato precedentemente e avviamo 
il computer. Quando verrà mostrata la console di 
Windows PE possiamo copiare l'immagine wi- 
nimg.wim dalla condivisione di rete del nostro com- 
puter di lavoro, sul computer di destinazione appe- 
na formattato: 

copy \\mypc\immagine\winimg.wim c:\ 

e poi eseguire nuovamente ImageX, questa volta per 
applicare l'immagine anziché generarla: 

d:\imagex /apply c:\winimg.wim I e: 

Dove 1 indica l'immagine da applicare che nel no- 
stro caso è la prima, visto che il file WIM da noi generato 
contiene solo un'immagine. Queste ultime opera- 
zioni possono essere eseguite su tutti i computer che 
si intende installare a partire dall'immagine creata e 
quindi in un numero indefinito di volte che è pro- 
prio lo scopo principale di WAIK. 



CONCLUSIONI 

Microsoft con il rilascio di WAIK ha voluto semplifi- 
care notevolmente la distribuzione e l'upgrade dei 
computer verso il suo nuovo sistema operativo Win- 
dows Vista ed anche per questo ha deciso di distri- 
buire gratuitamente a tutti questo kit affinché chiun- 
que potesse utilizzarlo per avviare il processo di mi- 
grazione nella propria azienda o nell'azienda per cui 
lavora. Certo WAIK non è uno strumento alla porta- 
ta di chiunque in quanto è comunque indispensa- 
bile una certa esperienza nell'utìlizzo di questo genere 
di applicazioni ma è sempre in ogni caso molto più 
amichevole rispetto agli strumenti del passato. 
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Realizziamo il gioco del 15 



APPLICAZIONI 
PRATICHE DI XAML 

XAML È LA NOVITÀ DEL MOMENTO E MOLTO SE NE STA PARLANDO MA COSA POSSIAMO 
REALMENTE FARE CON QUESTA NUOVA TECNOLOGIA? VEDIAMOLO CON UN ESEMPIO 
CONCRETO. IMPAREREMO COME SFRUTTARE IL DRAG & DROP 




LI CD LI WEB 

Applicazionijratiche_di_XAML.zip 



^ 




■W.).MtiJ.»JJti.)Uffl, 
— Conoscenze base di C# 
<-*, - e concetti base di 
XAML 



Windows XP Home o 
Professional - Visual 
Studio 2005 o Express 

- .NET Framework 3.0 

- Visual Studio 2005 
extensions for .NET 
Framework 3.0 (WCF 
& WPF) - DirectX 9.0 o 
sup. 



0000 



XAML è la moda del momento così come lo è 
stato e lo è ancora Ajax. A differenza di que- 
st'ultimo, però, XAML insieme a tutto il nuo- 
vo .NET Framework 3.0 è realmente una novità, in 
quanto prima del loro arrivo non era possibile svi- 
luppare applicazioni così ricche graficamente se non 
con notevoli sforzi e con l'utilizzo di tecnologie mol- 
to complesse. Uno degli aspetti più visibili ed accat- 
tivanti di questa nuova tecnologia è rappresentato 
dalle animazioni e dai nuovi oggetti panel dedicati 
alla visualizzazione degli elementi grafici. È su que- 
sti infatti che ci concentreremo maggiormente. Nel pre- 
sente articolo quindi affronteremo lo sviluppo in am- 
biente web e vedremo come realizzare inWPF/E, ov- 
vero Windows Presentation Foundation Everywhe- 
re, il famosissimo gioco del "Quindici" a cui i meno gio- 
vani di noi sicuramente ricorderanno di aver gioca- 
to nella loro infanzia. Spieghiamo brevemente in co- 
sa consiste questo gioco per coloro che non lo co- 
noscessero. In pratica il gioco del Quindici nella sua 
versione tradizionale, era un quadratino in plastica con- 
tenente quindici tesserine numerate da 1 a 15 libere 
di muoversi di una posizione in verticale od in oriz- 
zontale. L'intera base contenente le caselline aveva 
una dimensione di 4x4 e quindi si veniva a creare uno 
spazio vuoto. Lo spazio in più doveva essere sfrutta- 
to per muovere le quindici tesserine di una posizio- 
ne per volta. Scopo del gioco era quello di riordina- 
re tutte le tesserine da uno a quindici partendo na- 
turalmente da uno stato disordinato. Vediamo nella 
seguente figura il risultato che otterremo al termine 
dell'articolo: 
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LA LOGICA DI GIOCO 

Uno dei concetti base di XAML è rappresentato da- 
gli elementi contenitori o Panel ovvero un conte- 
nitore di oggetti come lo era il Panel delle versioni 
precedenti del .NET Framework. Ma a differenza 
di prima ora XAML ci mette a disposizione diver- 
si tipi di Panel ognuno con una propria specializ- 
zazione. Tra i vari tipi di panel troviamo l'oggetto Grid 
che per la sua natura è quello che si presta mag- 
giormente alla creazione del nostro gioco. In pra- 
tica l'oggetto Grid è un panel che suddivide il suo 
contenuto per righe e colonne come ad esempio 
avviene per una tabella HTML: 
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spostamenti TeTips irascora): 00:00:09 sec. 

Figura 1: Il gioco del quindici in XAML all'avvio 



Figura 2: L'oggetto Grid in Visual Studio 



Ogni oggetto contenuto in un Grid eredita da que- 
sto due proprietà (Grid.Column e Grid.Row) che 
indicano rispettivamente la Colonna e la Riga in 
cui l'oggetto è posizionato e attraverso la modifica 
di queste proprietà è possibile spostare l'oggetto 
in una qualsiasi delle celle della griglia. Sostan- 
zialmente ciò che faremo sarà creare un Grid di 4 
colonne per 4 righe in cui posizioneremo quindi- 
ci Label a rappresentare le nostre tessere del gioco 
lasciandone una vuota che sarà la nostra tessera 
"zero". Ciascuna Label visualizzerà un numero e 
potrà essere spostata in orizzontale od in vertica- 
le nel caso in cui questa sia adiacente alla cella li- 
bera. Dovremo quindi gestire l'evento MouseDown 
dell'oggetto Grid e verificare se la cella su cui si è clic- 
cato confina con la cella libera. In tal caso modifi- 
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cheremo opportunamente le proprietà Column e 
Row per spostare la Label nella cella prima occupata 
dalla casella vuota. Per abbellire un po' il tutto ap- 
plicheremo un semplice effetto di sfumatura alla cel- 
la durante lo spostamento, inseriremo un conta- 
tore di spostamenti per capire, in caso di vittoria, 
in quante mosse siamo riusciti a risolvere il gioco 
ed infine visualizzeremo anche un piccolo timer 
che ci dirà il tempo trascorso dall'inizio del gioco. 
Per quanto riguarda il timer, se proviamo ad uti- 
lizzare il tipico oggetto Timer del namespace Sy- 
stem. Timers ci accorgiamo subito che non è possibile 
usarlo in quanto alla prima esecuzione e al verifi- 
carsi del primo evento Elapsed verrà sollevata l'ec- 
cezione: 

System. InvalidOperationException: The calling thread 
cannot access this object because a different thread 

owns it 

Questo accade perché gli oggetti dell'interfaccia 
grafica di WPF vengono instanziati in un thread 
diverso da quello in cui vengono creati i timer del 
namespace System. Timers. Non potendo utilizza- 
re il classico Timer a cui siamo abituati, ci viene in 
aiuto un nuovo oggetto timer chiamato Di- 
spactherTimer che a differenza del primo, gira nel- 
lo stesso thread degli oggetti di interfaccia di WPF 
e quindi può accedere ad essi. 
Dopo aver installato le estensioni Visual Studio 
2005 extensions for .NET Framewok 3.0 (WCF & 
WPF) troviamo tra i project template di Visual Stu- 
dio nel ramo NET Framework 3.0 il nuovo templa- 
te XAML Browser Application (WPF). Creato quin- 
di un nuovo progetto XAML Browser troviamo nel 
progetto alcuni file tra cui quello che ci interessa è 
Pagel.xaml ovvero la nostra pagina XAML nella 
quale andremo ad inserire tutti gli oggetti dell'in- 
terfaccia del nostro gioco. Nel codice allegato tro- 
vate l'intero progetto che ora andremo a com- 
mentare. 



pò trascorso dall'inizio del gioco. 
Vediamo ora più nel dettaglio la composizione del- 
l'oggetto Grid. L'oggetto Grid prevede la definizio- 
ne di due sezioni Definitions, ovvero della defini- 
zione delle colonne e delle righe della griglia: 
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<ColumnDefinition Width = ' 


50" /> 




<ColumnDefinition Width = ' 


50" /> 




<ColumnDefinition Width = ' 


50" /> 




<ColumnDefinition Width = ' 


50" /> 


</G 


rid.ColumnDefinitions> 






<Gr 


d.RowDefinitions> 






<RowDefinition Height="50 


'/> 




<RowDefinition Height="50 


'/> 




<RowDefinition Height="50 


'/> 




<RowDefinition Height="50 


'/> 


</G 


rid.RowDefinitions> 





Queste definizioni specificano di creare all'interno 
del Grid quattro colonne e quattro righe di di- 
mensione 50 DIP. Cogliamo l'occasione per spe- 
cificare che i valori utilizzati per le proprietà Width 
ed Height non sono, come si potrebbe credere, spe- 
cificati in semplici pixel, bensì in una nuova unità 
di misura denominata Device Independent Pixels, 
ovvero DIR Un DIP equivale ad 1/96 di pollice e 
questa unità di misura è stata utilizzata per per- 
mettere alle applicazioni di poter adattarsi alla ri- 
soluzione dello schermo su cui vengono visualiz- 
zate e quindi poter essere viste senza problemi su 
device molto diversi tra loro (quali ad esempio pal- 
mari, telefoni cellulari, PDA, ecc) . 
Subito dopo definiamo tutte le Label che saranno 
contenute nella griglia e che visualizzeranno i nu- 
meri delle tessere del gioco: 

<Label Grid.Column="0" Grid.Row="0" Width="48" 

Height="48" Name="lblUno" FontSize="22" 

HorizontalContentAlignment= "Center" 

Background = "LightBlue" 

VerticalContentAlignment= "Center" >1</Label> 



IMPLEMENTAZIONE <Label Grid.Column="l" Grid.Row = "0" Width = "48" 
Nella pagina XAML è presente un pannello Can- Height="48" Name="lblDue" FontSize="22" 
vas che imposta le dimensioni massime della gri- HorizontalContentAlignment="Center" 
glia e che contiene la Label visualizzata in caso di Background="LightBlue" 
vittoria. All'interno di questo Canvas troviamo uno VerticalContentAlignment="Center">2</Label> 
StackPanel, ovvero un pannello il cui contenuto 
viene "impilato" in modo tale da essere visualiz- 
zato ordinatamente in verticale od in orizzontale 

Nel nostro caso l'ordinamento sarà verticale. Al- 
l'interno dello StackPanel troviamo l'oggetto Grid, Ogni Label imposta le proprietà Column e Row 
subito sotto troviamo il Button che permette di ri- ereditate dall'elemento Grid. In ogni caso questa pri- 
cominciare il gioco e mescolare le tessere ed infi- ma impostazione di partenza con le Label ordina- 
ne troviamo un WrapPanel che ospita diverse La- te verrà successivamente variata quando le casel- 
bel, tra cui il contatore degli spostamenti ed il tem- le saranno mescolate in modo random. 




REFERENZIARE 
DLL MEI 
PROGETTI 

In Visual Studio per 
referenziare un 
assembly in un 
progetto è sufficiente 
cliccare con il tasto 
destro del mouse sul 
nome del progetto, 
scegliere la voce Add 
Reference... , cliccare 
sul tab Browse e 
selezionare dal disco 
rigido la DLL che 
s'intende referenziare 
nel progetto. 
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IL .NET 

FRAMEWORK 

3.0 

Per eseguire il codice 

allegato a questo 

articolo e per 

sviluppare in XAML 

è necessario avere già 

installato sulla propria 

macchina il .NET 

Framework 3.0 che 

è possibile recuperare 

a questo indirizzo: 

http://www,microsoft. 

com/downloads/details. 

aspx?Famiivld=10CC340B 

-F857-4A14-83F5- 

25634C3BF043&displavla 

nq=en 



Subito sotto la griglia troviamo il tasto per l'inizia- 
lizzazione del gioco: 

<Button Name="cmdNewGame" Width="100" 

Padding = "0, 0,2,1" Margin="0, 10,0, 0"> Nuovo 
Gioco</Button> 

In questo caso non troviamo alcuna specificità se 
non la presenza delle proprietà Padding e Margin 
che si riferiscono rispettivamente allo spazio tra il 
bordo del tasto ed il suo contenuto interno e la di- 
stanza tra i bordi del tasto e gli elementi che lo cir- 
condano. 

Per ultimo troviamo ilWrapPanel che contiene le La- 
bel degli spostamenti e del tempo impiegato: 

<WrapPanel HorizontalAlignment= "Center" 

Margin = "0,10,0,0"> 
<Label Width = "110" BorderBrush="Black" 

BorderThickness="l" Height="24" 

Name="lblCounter" Background = "#44808080" 

FontWeight="Bold" HorizontalAlignment="Center" 

HorizontalContentAlignment= "Center" >0 

spostamenti </La bel > 

<l_abel Width = "94" Height="24" 

Name="lblTimerTitle" Background = "#44008080" 

FontFamily="Bold" HorizontalAlignment="Center" 

HorizontalContentAlignment="Right">Tempo 

trascorso: </Label> 

<Label Height="24" Name="lblTimer" 

Background = "#44008080" FontFamily="Bold" 

HorizontalAlignment="Stretch" 

HorizontalContentAlignment="Left">00:00:00</Label 

> 
<Label Height="24" Name="lblTimerSec" 

Background = "#44008080" FontFamily="Bold" 
HorizontalAlignment="Stretch" 
HorizontalContentAlignment="Left">sec.</Label> 
</WrapPanel> 



Questa sezione definisce le risorse condivise di pa- 
gina. Possiamo considerare le risorse di pagina co- 
me una Hashtable che può contenere una serie di 
oggetti a cui possiamo accedere specificando una 
chiave. In questo caso la nostra chiave è rappre- 
sentata dall'attributo x:Key=" chiave" . 
Nelle risorse abbiamo inserito una DoubleAnima- 
tion che usiamo per animare una Label nel mo- 
mento in cui questa viene spostata ed uno Storyboard 
che utilizziamo per animare una Label che non 
può essere spostata. 

Nel primo caso la definizione completa dell'ani- 
mazione è presente nel code behind della pagina 
perché, come vedremo, abbiamo la necessità di 
riutilizzare l'animazione con differenti parametri, 
mentre per quanto riguarda l'animazione dello 
Storyboard, questa è definita direttamente in XAML 
in quanto non prevediamo di modificarne da co- 
dice i parametri. 

Passiamo ora al code behind della pagina XAML. Nel 
costruttore della classe Page, inizializziamo la gri- 
glia disponendo casualmente le tessere e regi- 
striamo i gestori di evento del click del mouse sul 
tasto per la creazione di un nuovo gioco e sulla gri- 
glia per la gestione del clic sulle caselle. 

public Pagel() 

{ 

InitializeComponent(); 



InitializeGridCells(); 



Grid.MouseDown += new 

MouseButtonEventHandler(Grid_MouseDown); 
cmdNewGame. Click += new 

RoutedEventHandler(cmdNewGame_Click); 



Per quanto riguarda la gestione degli eventi, in 
XAML abbiamo due possibilità. Possiamo definire 
i gestori di evento direttamente in XAML: 



All'interno del tag Page troviamo la sezione Pa- 
ge.Resources: 



<Button Name="cmdNewGame" 
Click="cmdNewGame_Click"> Nuovo Gioco</Button> 



<Page.Resources> 



<DoubleAnimation 



x:Key="swapAnimation" 



Duration = "0:0:1.0" /> 



<Storyboard 



x:Key="noSwapStory Board" 



Story board. TargetProperty= "(Background). (SolidColor 

Brush.Color)"> 



<ColorAnimation 



From ="LightBlue" 



To ="Red" 



Duration = "0:0:0.1" 



AutoReverse="True" /> 



</Storyboard> 



</Page. Resources > 



Oppure possiamo associare gli Event Handler da 
code behind, come abbiamo fatto nel nostro ca- 
so: 

cmdNewGame. Click += new 

RoutedEventHandler(cmdNewGame_Click); 

Al momento l'unica differenza apprezzabile nella 
scrittura, tra queste due metodologie, è riscontra- 
bile nel fatto che nel primo caso l'event handler ci 
viene creato direttamente da Visual Studio pre- 
mendo due volte il tasto TAB subito dopo aver di- 
gitato i caratteri += mentre nel secondo caso dob- 
biamo scrivere noi manualmente il metodo del ge- 
store. Ma questa è evidentemente una limitazio- 
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ne del Designer di Visual Studio che sarà presto su- 
perata. 

Creiamo inoltre il timer che ci servirà per visualiz- 
zare il tempo trascorso dall'inizio del gioco: 



_timer = new DispatcherTimer(); 


_timer.Interval = new TimeSpan(0, 0, 1); 


_timer.Tick += new EventHandler(_timer_Tick); 


_timer.Start(); 


} 



Il metodo preposto all'inizializzazione della gri- 
glia utilizzando la classe Random, genera 16 cop- 
pie di numeri casuali che diventeranno le righe e le 
colonne delle sedici caselle del gioco. In questo 
metodo vediamo la collection Children dell'og- 
getto Grid che espone tutti gli oggetti (di tipo UIE- 
lement) presenti nella griglia, nel nostro caso i chil- 
dren sono le Label contenenti i numeri delle tessere 
del gioco. Attraverso l'utilizzo dei due metodi 
Grid.SetColumn e Grid.SetRow è possibile impo- 
stare la riga e la colonna in cui vogliamo posizionare 
uno specifico elemento dell'interfaccia: 



private void InitializeGridCells() 



{ 



Random rnd = new 

Random(DateTime.Now.Millisecond); 
List<string> colsAndRows = new 

List<string>(16); 



int col = 0; 



int row = 0; 



while (colsAndRows. Count < 16) 



{ 



col = rnd.Next(0, 4); 



row = rnd.Next(0, 4); 



if (!colsAndRows.Contains(col.ToString() + "|" 
+ row.ToString())) 



{ 



colsAndRows. Add(col.ToString() + "|" + 

row.ToStringQ); 



} 



int 



foreach (UIEIement elem in Grid. Children) 



{ 



Grid.SetColumn(elem, 

int.Parse(colsAndRows[i].Split(T)[0])); 
Grid.SetRow(elem, 

int. Parse(colsAndRows[i].Split('| ')[!])); 



} 



} 



Il gestore dell'evento MouseDown del Grid verifi- 
ca che il click sia stato effettuato su di una Label, ese- 
gue lo spostamento della casella (se questo è con- 
sentito) e quindi avvia l'animazione che visualiz- 



zerà un effetto di sfumatura sulla Label cliccata. 
Se lo spostamento non è consentito, viene avviato 
lo Storyboard ritornato dal metodo GetError- 
StoryBoard e dedicato alla visualizzazione di un'a- 
nimazione d'errore: 



private void Grid_MouseDown(object sender, 

MouseButtonEventArgs e) 


{ 


object obj = e.Source; 


if (obj is Label) 


{ 


Label currentLabel = 


= ((Label)obj); 




if (SwapCell((UIEIement)obj)) 


{ 


currentLabel. BeginAnimation(Label.OpacityProperty, 
GetAnimation(0.0, 1.0, 0.1, false)); 


} 


else 


{ 


currentLabel. BeginStoryboard(GetErrorStoryBoard( 

currentLabel. Nanne)); 


} 


} 


} 



Il metodo BeginAnimation richiede come para- 
metri la proprietà dell'oggetto che vogliamo mo- 
dificare (e quindi animare) e urìAnimationTime- 
line, cioè un oggetto che definisce il tipo di valore 
da assegnare alla proprietà da animare ed il tempo 
che deve trascorrere tra l'inizio ed il termine del- 
l'animazione. Nel nostro caso utilizziamo una Dou- 
bleAnimation (restituitaci dal nostro metodo Ge- 
tAnimation) che farà variare la proprietà Opacity- 
Property dal valore 0.0 al valore 1.0 a passi di 0.1 
nell'arco di tempo di un secondo. Il metodo Be- 
ginStoryboard richiede invece uno Storyboard da 
associare all'oggetto specificato. Anche in questo 
caso abbiamo un metodo che restituisce lo Story- 
board dato il nome dell'oggetto a cui intendiamo 
applicarlo. 

Con GetAnimation ritorniamo un oggetto Dou- 
bleAnimation che rappresenta un'animazione, ri- 
cevendo come parametri il valore di partenza, il 
valore di arrivo, il valore dello step ed il valore del- 
la propvielh AutoReverse che indica se ripetere l'a- 
nimazione quando questa è arrivata al valore di 
arrivo oppure fermarsi. L'oggetto DoubleAnima- 
tion viene recuperato dalle risorse tramite l'uso del 
metodo FindResource: 

private DoubleAnimation GetAnimation(double from, 
doublé to, doublé by, bool autoReverse) 

1 

_da = 
(DoubleAnimation) FindResource("swapAnimation"); 




DOVE 

TROVARE 

LE ESTENSIONI 

.NET 3.0 PER 

VISUAL STUDIO 

Le estensioni 

necessarie per 

permettere di 

sviluppare in .NET 3.0 

con Visual Studio, 

possono essere 

scaricate dal seguente 

indirizzo: 

http://www.microsoft.co 

m/downloads/details.aspx 

?familvid=F54F5537- 

CC86-4BF5-AE44- 

F5A1E805680D&displavla 

nq=en 
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WIIMFX SDK 

L'SDK per sviluppare in 

XAML cosi come altro 

utile materiale per 

sviluppare in .NET 3.0 

lo potete trovare a 

questo indirizzo: 

http://msdn, microsoft. 

com/winfx/downloads/ 



// Animazione casella spostata 


_da.From = from; 


_da.To = to; 


_da.By = by; 


_da.AutoReverse = autoReverse; 




return _da; 


} 



Invece il metodo GetErrorStoryBoard ritorna un 
oggetto Storyboard (anch'esso recuperato dalle ri- 
sorse di pagina) dopo aver impostato la sua pro- 
prietà TargetName che gli indicherà la Label sulla 
quale applicare l'animazione: 

private Storyboard GetErrorStoryBoard( string 

targetName) 

1 

_errStoryBoard = 

(Storyboard) FindResource("noSwapStory Board"); 
_errStory Board. SetValue(Story board. TargetNameProp 

erty, targetName); 



return _errStoryBoard; 



} 



A questo punto vediamo il metodo SwapCell che ef- 
fettua materialmente lo spostamento delle celle. 
Innanzitutto ricaviamo la riga e la colonna della 
Label vuota e della Label che intendiamo sposta- 
re utilizzando i metodi Grid.GetColumn e Grid.Ge- 
tRow dell'oggetto Grid: 

private bool SwapCell(UIEIement swappedCell) 

{ 

bool retVal = true; 

// Riga e Colonna della cella Zero 

int zColumn = Grid.GetColumn(lblZero); 

int zRow = Grid.GetRow(lblZero); 

// Riga e Colonna della cella selezionata 

int tmpColumn = Grid.GetColumn(swappedCell); 

int tmpRow = Grid.GetRow(swappedCell); 

Poi con un semplice calcolo verifichiamo che la 
Label da spostare confini in orizzontale od in ver- 
ticale con la Label vuota: 



if ((zColumn == tmpColumn && Math.Abs(zRow 

- tmpRow) ==1) 

| (zRow == tmpRow && Math.Abs(zColumn - 
tmpColumn) == 1)) 
{ 

Due celle sono contigue semplicemente se sono 
sulla stessa colonna e distano tra loro di una riga op- 
pure se sono sulla stessa riga e distano tra loro di una 
colonna. 



Verificato quindi con questo calcolo che la Label 
cliccata può essere spostata, utilizzando i metodi 
Grid.SetColumn e Grid.SetRow invertiamo le po- 
sizioni delle due Label ottenendo come risultato 
che queste si scambieranno di posto: 



Grid.SetColumn(swappedCell, zColumn); 


Grid.SetRow(swappedCell, zRow); 


Grid.SetColumn(lblZero, tmpColumn); 


Grid.SetRow(lblZero, tmpRow); 


UpdateCounter( false); 


} 


else 


{ 


retVal = false; 


} 



Subito dopo lo swap aggiorniamo il contatore 
degli spostamenti con il metodo UpdateCoun- 
ter. 

Ora possiamo controllare che lo schema sia sta- 
to completato, verificando con il nostro metodo 
IsCompleted che tutte le celle siano nella posi- 
zione corretta. Se così è, visualizziamo la Label 
IblWin che mostra il messaggio di vittoria appli- 
cando anche ad essa un'animazione che le darà 
l'effetto di partire dal centro dello schermo ed 
ingrandirsi fino a raggiungere le dimensioni del- 
l'intera griglia: 



if (IsCompleted()) 



{ 



IblWin. Visìbility = Visibility.Visible; 



IblWin. BeginAnimation( Label. WidthProperty, 



GetAnimation( 0, 200, 10, false)); 



Ibi Win. BeginAnimation( Label. HeightProperty, 

GetAnimation(0, 200, 10, false)); 

IblWin. BeginAnimation(Canvas.TopProperty, 

GetAnimation(100, 0, 10, false)); 

lblWin.BeginAnimation(Canvas.LeftProperty, 

GetAnimation(100, 0, 10, false)); 



_timer.Stop(); 



} 



return retVal; 



} 



Anche in questo caso abbiamo utilizzato il meto- 
do BeginAnimation della Label passandogli il no- 
me della proprietà che vogliamo modificare ed il ti- 
po di animazione da applicare. Nel caso specifico 
animeremo contemporaneamente le quattro pro- 
prietà Label. WidthProperty, Label.HeightProperty, 
Canvas. TopProperty e Canvas.LeftProperty. Quin- 
di al termine dell'animazione, fermiamo il timer 
che lascerà visibile il tempo impiegato per risol- 
vere il gioco. 
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AVVIAMO IL GIOCO 

Per giocare con il nostro gioco del Quindici, pre- 
miamo F5 ed attendiamo che Visual Studio faccia 
partire Internet Explorer. A questo punto possia- 
mo iniziare a giocare spostando le caselle cliccan- 
dole con il mouse. Ogni spostamento farà incre- 
mentare il contatore e nel frattempo il timer vi- 
sualizzerà il tempo trascorso dall'inizio del gioco. 
Quando riusciremo a ordinare tutte le celle da uno 




Tempc trascorse: 00:06:57 sec. 



Figura 3: Label visualizzata in caso di vittoria. 



Al termine della pubblicazione, verrà avviato In- 
ternet Explorer con caricata la pagina publish.htm 
la quale ci richiederà l'installazione dell'applica- 
zione (ricordiamo che le applicazioni WPF/E ven- 
gono installate tramite ClickOnce). Premiamo quin- 
di il tasto Rum 
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Figura 5: Installazione dell'applicazione XBAP 



a quindici, vedremo apparire con un'animazione 
la Label di vittoria. 

A questo punto possiamo premere il tasto New Ga- 
me per rimescolare le tessere ed iniziare una nuo- 
va partita. Oltre che lanciare l'applicazione da Vi- 
sual Studio possiamo però anche pubblicarla su 
US come una qualsiasi Web Application. Per fare 
questo è sufficiente: 

1. cliccare con il tasto destro del mouse sul nome 
del progetto 

2. selezionare Publish... 

3. selezionare la virtual directory in cui si intende 
pubblicare l'applicazione 

4. selezionare l'opzione per rendere disponibile 
l'applicazione solo in modalità online 

5. premere Finish per confermare 
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Alla pressione del tasto Run verrà avviata l'instal- 
lazione dell'applicazione: 

Al termine dell'installazione finalmente vedremo 
apparire il nostro gioco del Quindici caricato da 
US e quindi pubblicabile anche online. Noteremo 
subito che il file caricato da Internet Explorer non 
avrà estensione html, xaml o aspx, bensì XBAP 
(XAML Browser Application) . Questa è l'estensio- 
ne delle applicazioni scritte in XAML perWPF/E e 
che vengono interpretate dall'applicazione Pre- 
sentationHost.exe (situata in C:\Windows\sy- 
stem32) preposta all'interpretazione del codice 
scritto inWPF per il web. 



CONCLUSIONI 

In questo articolo abbiamo visto solo una piccola 
parte di tutto quello che XAML permette di fare 
ma è sufficiente per introdurci gradualmente ai 
nuovi concetti che tra breve dovremo imparare a pa- 
droneggiare per essere al passo con i tempi. Mol- 
te cose al momento in cui scriviamo sono allo sta- 
to grezzo ed ancora in fase di sviluppo e quindi al- 
cune cose che vanno fatte manualmente possono 
sembrare complicate ma quando tra breve queste 
tecnologie saranno mature e verranno rilasciate le 
versioni definitive dei diversi componenti e tool di 
sviluppo, il tutto sarà molto più facile da imple- 
mentare e da utilizzare e finalmente potremo for- 
nire applicazioni dall'aspetto più innovativo e user 
friendly. 
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Figura 4: Avvio installazione ClickOnce dell'applicazio- 
ne XBAP 



Gianni Malanga 



http://www.ioprogrammo.it 



Giugno 2007/ 69 ► 



072-077 27-04-2007 12:17 Pagina 72 



SISTEMA T ■ Windows Presentatimi Foundation 



DISEGNAMO UN 
FORM CON WPF 

RIDEFINIRE UN FORM CON .NET NON È COSA IMPOSSIBILE MA TUTT'ALTRO CHE BANALE 
E NON SEMPRE CON RISULTATI ENTUSIASMANTI. OGGI, GRAZIE AGLI OGGETTI MESSI 
A DISPOSIZIONE DAL NUOVO ENGINE GRAFICO WPF, TUTTO È SEMPLIFICATO 
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Windows Presentation 
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Una delle novità introdotte dal Microsoft .NET 
Framework 3.0 è senz'altro Windows Pre- 
sentation Foundation, il nuovo engine per 
la creazione di Interfacce Utente. 
Oltre ad avanzate funzionalità di presentazione 3D, 
WPF, permette la creazione di interfacce utente mol- 
to più avanzate ed accattivanti rispetto agli strumenti 
già esistenti. WPF nasce, infatti, per sostituire l'at- 
tuale GDI che tutto sommato non ha grosse limitazioni 
ma ha il difetto di essere fortemente orientato al pixel 
e basato quindi su un modello ormai sorpassato. WPF 
mette a disposizione nuovi oggetti per disegnare og- 
getti vettoriali. 

Per poter disegnare qualsiasi cosa con Windows Pre- 
sentation Foundation possiamo utilizzare la libreria 
Shapes ovvero tutti gli oggetti contenuti nel name- 
space System.Windows.Shapes. Questo namespace 
contiene diverse classi ognuna relativa ad un diver- 
so oggetto o forma grafica. Se, ad esempio, volessi- 
mo disegnare una semplice linea, utilizzeremo Line: 

<Line Xl = "100" Yl="50" X2="400" Y2="100" 

Stroke="Blue" /> 

Oppure per disegnare una forma circolare, ecco la 
classe Ellipse: 

<Ellipse Width="100" Height="70" Stroke="Red" 

Fill = "Red" /> 

O ancora, se vogliamo ottenere un rettangolo, ecco la 
classe Rectangle: 

<Rectangle Width = "200" Height="110" Stroke= 

"Green" Canvas.Left="50" Canvas.Top="80"/> 

Inoltre, in Shapes, è contenuta la classe Path. L'og- 
getto Path è in assoluto il potente e completo dei pre- 
cedenti e, in teoria, sarebbe possibile creare avanza- 
te interfacce utilizzando solamente quest'ultimo og- 
getto con il solo svantaggio di non avere del codice mol- 
to prolisso rispetto a quello scritto con le più fami- 
liari classi Line, Ellipse o Rectangle. 
Possiamo quindi disegnare un'ellisse anche utiliz- 



zando Path in questo modo: 



<Path Fill="Red' 


Stroke= 


"Red 


'> 








< Path. Data > 


<EllipseGeometry Center= 


196,144 


1 RadiusX 












"144" 


}adiusY= 


96" 


/> 


</Path.Data> 


</Path> 



Con queste semplici righe XAML, abbiamo ottenuto 
diverse forme base sul nostro form come possiamo 
vedere in Fig.l. 



^^ihi 



















Figura 1: Alcuni oggetti Shapes in azione 

Oltre alle solite proprietà per le dimensioni e posi- 
zioni della forma disegnata, queste classi hanno due 
proprietà di tipo Brush: Stroke e Fili. La prima indica 
il "tratto" da utilizzare per disegnare mentre la se- 
conda indica il "riempimento" che può essere un 
semplice colore o qualcosa di più avanzato come ad 
esempio un'immagine bitmap. 



DISEGNAMO 
uni OROLOGIO 

Iniziamo, a questo punto, a disegnare qualcosa di più 
carino come ad esempio un orologio e, per rendere 
le cose più interessanti, realizzeremo un classico oro- 
logio con lancette 

Inoltre, per utilizzare appieno le potenzialità vettoriali 
di WPF, non daremo delle dimensioni fisse alla figu- 
ra ma queste saranno relative al ridimensionamen- 
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to del form da parte dell'utente in modo da apprez- 
zare il fatto che, in qualsiasi risoluzione o qualsiasi 
tipo di display, il disegno non assume aspetti diver- 
si. 

Da Visual Studio selezioniamo File->New Project e, se 
abbiamo installato correttamente le estensioni per 
Windows Presentation Foundation, dovrebbe appa- 
rire nell'elenco dei tipi di progetto "NET Framework 
3.0" e neiTemplates "Windows Application (WPF)" co- 
me in Fig. 2. 



HD 



J3Savdi£r*»1Malac.. 




H=~|C 



Figura 2: Creazione del nuovo progetto WPF in Visual 
Studio 2005 



Apriamo il file Windowl.xaml e creiamo l'elemento 
root nel nostro file XAML in questo modo: 

<Window x:Class="ClockForm.Windowl" 

xmlns= "http://schemas.microsoft.com/winfx/ 

2006/xaml/presentation" 
xmlns:x= "http://schemas.microsoft.com/winfx/ 

2006/xaml" 
xmlns:s="clr-namespace: System ;assembly 

=mscorlib" 
Title="WPF Chronometer"> 



<Window.Resources> 
<!— Qui verranno definite le risorse necessarie al 

funzionamento del nostro orologio. 
Per adesso resterà vuoto — > 
</Window.Resources> 



<Viewbox> 
<Canvas Height="300" Width="300"> 
<!— Il content del Canvas sarà il nostro orologio 



</Canvas> 
</Viewbox> 

</Window> 

Con queste righe abbiamo semplicemente definito un 
oggetto Window dove verrà disegnato il nostro oro- 
logio e, le uniche cose in più rispetto ad una finestra 
generata automaticamente da Visual Studio sono: 

• La riga xmlns:s= "clr-namespace:System;assem- 
bly=mscorlib", definita per poter utilizzare delle 



classi che non sono dll XAML e, definendo il pre- 
fisso "s", questo renderà possibile l'accesso a tutte le 
classi e strutture presenti nel namespace System e 
deH'assembly mscorlib.dll; 

• <Window.Resources>. . . </Window.Resources> dove 
successivamente verranno definite le risorse ne- 
cessarie al funzionamente del nostro orologio, co- 
me ad esempio l'orario attuale; 

• <Viewbox>, un controllo molto importante in WPF 
che, come vedremo, permette l'adattamento auto- 
matico del contenuto rispetto al contenitore. Nel 
nostro caso nostro orologio (contenuto) verrà au- 
tomaticamente ridimensionato al ridimensiona- 
mento della Window (contenitore); 

• Infine il Panel <Canvas> che, tra tutti i tipi di Panel 
presenti in WPF, è il più indicato nel nostro caso in 
quanto permette il posizionamento assoluto dei 
controlli al suo interno. 

Tutto il nostro orologio sarà, quindi, contenuto nel- 
l'oggetto Canvas. 

Iniziamo a disegnare il bordo del nostro orologio per 
mezzo della classe Patii che, come già descritto, è il più 
potente degli oggetti e possiamo, quindi, utilizzarlo 
per disegnare qualsiasi cosa . 

Per prima cosa definiamo il bordo esterno: 

<!— Bordo Esterno — > 



<Path Name="bordoEsterno" StrokeThickness= 



"10"> 



<Path.Stroke> 



<LinearGradientBrush> 



<GradientStop Color="LightSlateGray" 



Offset="0" /> 



<GradientStop Color="Silver" Offset="l" /> 



</LinearGradientBrush> 



</Path.Stroke> 



<Path.Data> 



<EllipseGeometry Center="150, 150" RadiusX 

= "120" RadiusY="120" /> 



</Path.Data> 



</Path> 



La proprietà più importante dell'oggetto Path è Da- 
ta, di tipo Geometry, una classe astratta da cui deri- 
vano classi come LineGeometry RectangleGeometry 
o EllipseGeometry Attraverso queste classi è possi- 
bile disegnare qualsiasi cosa che verrà visualizzata 
da Path. Nel nostro caso abbiamo utilizzato un Elli- 
pseGeometry per disegnare, ovviamente, un cerchio 
impostando la proprietà Center (150, 150), ossia le 
coordinate del centro del nostro Canvas, e le pro- 
prietà RadiusX e RadiusY per impostare il raggio del 
nostro cerchio. 

Il bordo del nostro orologio lo definiamo attraverso 
le proprietà Stroke e StrokeThickness che indicano, 
rispettivamente, il colore del bordo e la sua larghez- 
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za. Per ottenere un effetto sfumato abbiamo dovuto 
definire come Brush un LinearGradientBrush con 
colore di partenza LightSlateGray e colore finale Sil- 
ver. A questo punto definiamo il bordo interno nel- 
la stessa maniera ma, per ottenere una sorta di ef- 
fetto 3D, la direzione della sfumatura le definiremo nel 
senso inverso alla precedente: 

<!— Bordo interno — > 

<Path Name="bordoInterno" StrokeThickness= 

"15" RII="White"> 
<Path.Stroke> 



< LinearGradientBrush > 



<GradientStop Color="Silver" Offset="0" /> 
<GradientStop Color="LightSlateGray" 

Offset="l" /> 



</LinearGradientBrush> 



</Path.Stroke> 



<Path.Data> 



<EllipseGeometry Center="150, 150" RadiusX 

="111" RadiusY="lll"> 



</EllipseGeometry> 



</Path.Data> 



</Path> 

A questo punto dovremmo avere già disegnato il bor- 
do del quadrante come mostrato in Fig. 3. 




Figura 3: II bordo del nostro orologio 

Ma entriamo adesso nei dettagli del nostro orologio 
disegnando il quadrante, gli indicatori dell'orario e le 
lancette. Per disegnare il quadrante utilizzeremo 
un'ellisse nero appena più piccolo del bordo men- 
tre, per gli indicatori, utilizzeremo la classe Line per 
creare delle tacche in corrispondenza delle ore 12, 3, 
6 e 9. 



<!— Quadrante nero con tacchette blu 


--> 




<Path Name="sfondoQuadrante" Fill=" 


Black 


> 


<Path.Data> 


<EllipseGeometry Center= 


'150,150" RadiusX 
"90" RadiusY="90" /> 


</Path.Data> 


</Path> 





<Line Xl = "150" Yl="75" X2="150" Y2="70" 

Stroke="Blue" StrokeThickness="2" /><!— 12 — > 
<Line Xl = "225" Yl="150" X2="230" Y2="150" 

Stroke="Blue" StrokeThickness="2" /><!— 3 — > 
<Line Xl = "150" Yl="225" X2="150" Y2="230" 

Stroke="Blue" StrokeThickness="2" /><!— 6 — > 
<Line Xl = "75" Yl = "150" X2="70" Y2="150" 

Stroke="Blue" StrokeThickness="2" /><!- 9 — > 



Abbiamo, ancora una volta, utilizzato un oggetto El- 
lipseGeometry nella proprietà Data della classe Path 
per creare un cerchio ma, con la differenza di non 
aver utilizzato la proprietà Stroke per il bordo bensì 
Fili in modo da definire un riempimento uniforme 
dello sfondo del quadrante. Per le tacche relative al- 
l'orario abbiamo usato, questa volta, la classe Line 
che definisce una linea a partire dalle coordinate del 
punto iniziale (XI, Yl) fino al punto finale (X2, Y2) 
con il colore definito attraverso la property Stroke e 
la larghezza con StrokeThickness. 
Passiamo adesso alle lancette che, come abbiamo 
fatto perle tacche, verranno disegnate utilizzando la 
classe Line in questo modo: 

<!— Lancetta delle ore — > 

<Line Name="lancettaOre" Xl="150" Yl="150" 

X2="150" Y2="100" 
Stroke="Blue" StrokeThickness="6" 
StrokeEndLineCap="Triangle" StrokeStart 

LineCap="Round"> 
</Line> 

<!— Lancetta dei minuti — > 

<Line Name="lancettaMinuti" Xl = "150" Yl = 

"150" X2 = "150" Y2 = "70" 
Stroke="Red" StrokeThickness="4" 
StrokeEndLineCap="Triangle" StrokeStart 

LineCap="Round"> 
</Line> 

<!— Lancetta dei secondi — > 
<Line Name="lancettaSecondi" Xl = "150" Yl = 

"150" X2 = "150" Y2 = "70" 
Stroke="Yellow" StrokeThickness="2" 
StrokeEndLineCap="Triangle" StrokeStart 

LineCap="Round"> 
</Line> 



Abbiamo, in questo modo, disegnato le tre linee raf- 
figuranti le lancette che partono dal centro del Can- 
vas (150, 150) e arrivano all'indicatore delle ore 12 ad 
eccezione della lancetta delle ore che è, naturalmente, 
più corta. Per adesso ci accontentiamo, quindi, di 
posizionare le lancette verso le ore 12, successiva- 
mente vedremo come posizionarle sull'orario attuale. 
In questo utilizzo della classe Line, saltano all'occhio 
due nuove proprietà: 

• StrokeEndLineCap - che indica come deve essere rap- 
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presentata la parte finale della linea 

• StrokeStartLineCap - che indica, invece, come de- 
ve essere rappresentata la parte iniziale della linea 

Le due property sono di tipo PenLineCap e possono 
assumere il valori: 

• Fiat - valore di default paragonabile ad una linea 
se inizio/fino particolare 

• Round- disegna un semicerchio all'estremità del- 
la linea 

• Square - disegna un rettangolo all'estremità con lo 
stesso spessore della linea 

• Triangle - rappresenta le estremità con un triango- 
lo equilatero con lunghezza pari allo spessore del- 
la linea 

Nel nostro caso abbiamo usato per le tre linee un ini- 
zio (centro del Canvas) Round mentre, per la parte 
finale un triangolo in modo da ottenere un vero e 
proprio effetto lancetta. 



IL POSIZIONAMENTO 
DELLE LANCETTE 

A questo punto il nostro orologio è completo, se non 
per il fatto di essere statico e visualizzare sempre le ore 
12. Vediamo adesso come, grazie alle nuove funzio- 
nalità di data binding, leggere l'orario attuale e rap- 
presentare questo valore sul nostro orologio. 
Il data binding in Windows Presentation Foundation 
è, finalmente, parte integrante dell'architettura del- 
l'engine e non un contorno come lo è tuttora nel 
mondo Windows Forms. 

Come illustrato nella Fig.4, il data binding è essen- 
zialmente il collegamento tra "binding target" (de- 
stinazione del dato) e un "binding source" (sorgente) . 
La figura dimostra, inoltre, alcuni concetti fonda- 
mentali nel binding in Windows Presentation Foun- 
dation: 

• Ogni operazione di binding coinvolge questi quat- 
tro parti: un oggetto binding target, una proprietà 
target, una sorgente binding, ed un percorso al va- 
lore nel binding source da usare. 

• La proprietà target deve essere una "Dependency 
Property" una novità ed in WPF la maggior parte 
degli elementi che interagiscono con la UI eredita- 
no indirettamente dalla classe DependencyObject 
la quale può essere vista come un contenitore di 
proprietà, in particolar modo di oggetti Depen- 
dencyProperty. 

• Anche se non specificato nella figura, l'oggetto sor- 
gente di binding non deve per forza limitarsi ad og- 
getti dati del CLR ma supporta qualsiasi oggetto co- 
me, ad esempio, controlli, oggetti list, oggetto as- 
sociato ad un datasourceADO.NET o web services, 



Binding Target 



Binding Source 



DependencyObject 



Dependency 
Property 



Binding Object 



Object 






: 



,j 



Property 



'd 



Figura 4: II data binding in Windows Presentation Foundation 



o un xmlnode che contiene dei dati. 

Un novità interessante è quella di poter agganciare tra 
loro i componenti visuali semplicemente usando 
l'attributo ElementName per indicare la fonte di bin- 
ding: 



<StackPanel> 



<TextBox Name="txtl" /> 



<TextBox Name="txt2" Text="{Binding Element 

Name=txtl, Path=Text, Mode=OneWay}" /> 
</StackPanel> 

In questo esempio, la proprietà Text della TextBox 
txt2 viene collegata a quella di txtl e, quindi, poiché 
la proprietà Text è una DependencyProperty, al va- 
riare del valore di txtl, verrà automaticamente ag- 
giornato il valore di txt2. Da questo capiamo, quindi, 
che in alcune situazioni il data binding potrebbe so- 
stituire benissimo l'utilizzo di eventi per la variazio- 
ne di elementi nell'interfaccia utente. 
Tornando al nostro orologio, potremmo utilizzare il 
data binding per leggere l'orario di sistema e rap- 
presentarlo con le lancette e vediamo, quindi, come. 
Cominciamo innanzitutto a leggere la data di sistema. 
Nella sezione Window.Resources precedentemente 
definita, aggiungiamo la riga: 

<!— Legge la data e orario attuale — > 
<FrameworkElement x:Key="dt" Tag="{x:Static s: 

DateTime.Now}" /> 

Utilizzando un FrameworkElement, abbiamo defi- 
nito "dt" a cui è abbinato l'orario attuale attraverso 
DateTime.Now. Definendo, quindi, "dt" nella sezio- 
ne Window.Resource, questa sarà disponibile in tut- 
ta la Window 

Per posizionare le lancette utilizzeremo gli oggetti 
TransformGroup che si occuperanno del calcolo ne- 
cessario. Per esempio, l'angolo iniziale della lancet- 
ta delle ore deve essere impostata come somma tra 30 
gradi per ogni ora e 0,5 gradi per ogni minuto. Ossia, 
per le 3:30 avremo 105 gradi come risultato di 
(3*30)+(30*0,5). 
Nella sezione Window.Resource aggiungiamo il se- 



CHE COSA È 
UNA 

DEPENDENCY 
PROPERTY? 

Una Dependency 
Property è una 
proprietà registrata 
con il nuovo sistema 
di Dependency 
Property di Windows 
Presentation 
Foundation. Infatti, 
vista la complessità 
dei controlli UI di WPF, 
che adesso possono 
essere anche formati 
da più controlli, 
questo sistema evita 
l'inutile instanza di 
proprietà non 
utilizzate. Maggiori 
approfondimenti 
all'indirizzo 
http://msdn2. microsoft, 
com/en-us/library/system. 
windows.dependencv 
propertv.aspx . 
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guente codice: 

<!— Moltiplica le ore per 30 gradi e i minuti per 

0,5 gradi e somma. 
Il risultato lo abbiamo in angleHour. 

Value.OffsetX. --> 
<TransformGroup x:Key="angleHour"> 
<TranslateTransform 

X="{Binding Source={StaticResource dt}, 

Path=Tag.Hour}" 
Y="{Binding Source={StaticResource dt}, 

Path=Tag. Minute}" /> 
<MatrixTransform Matrix="30 0.5 1 0" /> 
</TransformGroup> 



In questo modo, attraverso l'uso di TranslateTran- 
sform, impostando X uguale all'ora eYuguale ai mi- 
nuti e moltiplicando tutto per una matrice con MI 1 
uguale a 30 e M21 uguale a 0,5 avremo il risultato in 
OffsetX che verrà utilizzato come valore della posi- 
zione attuale della lancetta delle ore. 
La definizione della lancetta delle ore sarà modifica- 
ta quindi in questa maniera: 

<!— Lancetta delle ore — > 

<Line Name="lancettaOre" Xl="150" Yl="150" 

X2="150" Y2="100" 
Stroke="Blue" StrokeThickness="6" 
StrokeEndLineCap="Triangle" StrokeStart 

LineCap="Round"> 
<Line.RenderTransform> 
<RotateTransform x:l\lame="xformHour" 
Angle="{Binding Source= 
{StaticResource angleHour}, Path=Value. OffsetX}" 

CenterX="150" CenterY="150"/> 
</Line.RenderTransform> 
</Line> 



Rispetto alla precedente definizione abbiamo, quin- 
di, aggiunto una trasformazione alla Line attraverso 
la proprietà RenderTransform applicando una rota- 
zione con angolo (Angle) uguale al valore di an- 
gleHour. Value.OffsetX definito nella sezione Resource 
dell'oggetto Window. 

Un discorso analogo vale per le lancette dei minuti e 
secondi. Definiamo altri due oggetti TransformGroup 
adattati naturalmente alle angolature dei minuti e 
secondi. 

<!— Moltiplica i minuti per 6 gradi e i secondi per 

0,1 gradi e somma. 
Il risultato lo abbiamo in angleMinute. 

Value.OffsetX. --> 
<TransformGroup x:Key="angleMinute"> 
<TranslateTransform 

X="{Binding Source={StaticResource dt}, 

Path=Tag. Minute}" 
Y="{Binding Source={StaticResource dt}. 



Patti =Tag.Second}' 


/> 


<MatrixTransform Matrix="6 0.1 1 0" /> 


</TransformGroup> 




<!— Moltiplica i secondi per 6 gradi. Il risultato lo 
abbiamo in angleSecond.Value.Mll. 


— > 


<TransformGroup x:Key="angleSecond"> 


<ScaleTransform 


ScaleX="{Binding Source= {StaticResource 


dt}, Path=Tag.Second}' 


/> 


<ScaleTransform ScaleX="6" /> 


</TransformGroup> 



Dopo aver definito, sempre nella sezione Resource, 
i due nuovi oggetto TransformGroup, colleghiamo 
l'angolatura delle lancette dei minuti e secondi con 
i valori restituiti dai TransformGroup. 
Modifichiamo, quindi, la definizione delle due lancette 
in questo modo: 

<!— Lancetta dei minuti — > 

<Line Name="lancettaMinuti" Xl="150" Yl = 

"150" X2 = "150" Y2 = "70" 
Stroke="Red" StrokeThickness="4" 
StrokeEndLineCap="Triangle" StrokeStart 

LineCap="Round"> 
< Line. RenderTransform > 
<RotateTransform x:Name="xformMinute" 

Angle="{Binding Source={Static 
Resource angleMinute}, Path=Value. OffsetX}" 
CenterX="150" CenterY="150"/> 



</Line. RenderTransform > 



</Line> 



<!— Lancetta dei secondi — > 



<Line Name="lancettaSecondi" Xl="150" Yl = 



"150" X2 = "150" Y2 = "70" 



Stroke="Yellow" StrokeThickness="2" 



StrokeEndLineCap="Triangle" StrokeStart 

LineCap="Round"> 



<Line.RenderTransform> 



<RotateTransform x:Name="xformSecond" 



Angle="{Binding Source= 



{StaticResource angleSecond}, Path=Value.Mll}" 



CenterX="150" CenterY="150"/> 



</Line. RenderTransform > 



</Line> 

Come abbiamo già fatto per la lancetta delle ore, ag- 
giungendo una trasformazione alle due lancette, l'an- 
golatura corrispondente verrà applicata in base al- 
l'orario attuale. 

Mandando in esecuzione la nostra applicazione, ve- 
dremo come le lancette verranno posizionate nelle ri- 
spettive coordinate anche se il lavoro non è ancora com- 
pleto. Infatti, le nostre lancette saranno comunque 
statiche e visualizzeranno solamente l'orario letto in 
fase di caricamento. 
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Vediamo, quindi, come usare le potenti funzionalità 
di animazione di Windows Presentation Foundation. 



ANIMIAMO IL TUTTO 

Le animazioni di WPF non sono poi così diverse 
da quelle ottenibili nelle applicazioni WinForm, 
entrambe si ottengono modificando dinamica- 
mente il valore di una o più proprietà di un ele- 
mento di UI, quello che distingue WPF è il mette- 
re a disposizione una serie di classi che rendono 
la modifica più semplice rispetto all'equivalente 
Windows Forms 2.0. 

Le classi di animazione sono divise in due gruppi e uti- 
lizzano un naming ben preciso: < TypoAnimation e 
<Type>Animation UsingKeyFrames dove <Type> rap- 
presenta il tipo della proprietà da animare. 
Se, ad esempio, vogliamo applicare un'animazione 
in modo che venga modificata la proprietà width di 
un button (che è di tipo Doublé) utilizzeremo Dou- 
bleAnimation. 

Le animazioni possono essere descritte conXAML, in 
questo caso però l'animazione deve essere racchiu- 
sa in una Timeline che, come per altro l'animazione 
stessa, rappresenta un intervallo di tempo, all'inter- 
no del quale possiamo animare contemporanea- 
mente più proprietà e affinché questo sia possibile 
dobbiamo racchiudere le animazioni in un conteni- 
tore di Timelines/Animazioni rappresentato dal- 
l'oggetto StoryBoard. 

Una volta definita l'animazione va specificato come 
questa deve partire, ecco perché le animazioni sono 
normalmente contenute all'interno di un Event- 
Trigger anche se posso essere contenute anche in 
uno style. 

Supponiamo di avere un pulsante che, al click, deve 
ingrandirsi, ma questo deve avvenire non di scatto 
da una dimensione all'altra, ma gradualmente in mo- 
do da ottenere un effetto di animazione. 

<StackPanel Orientation = "Vertical" Name="spl"> 
<StackPanel.Triggers> 
<EventTrigger RoutedEvent= "Button. Click" 

SourceName="btnAnimate"> 
<EventTrigger.Actions> 
<BeginStoryboard> 
<Storyboard> 
<DoubleAnimation From = "100" To="200" 

Duration = "0:0:2" 
AutoReverse="True" 
RepeatBehavior="Forever" 
Storyboard.TargetName="btnAnimate" 
Storyboard.TargetProperty= "Width" /> 
</Storyboard> 
</BeginStoryboard> 
</EventTrigger.Actions> 
</EventTrigger> 



</StackPanel.Triggers> 



<Button Name="btnAnimate" Width = "100" Height 

= "70" Content="ClickMe!"/> 
</StackPanel> 

In questo modo abbiamo definito una animazio- 
ne sulla proprietà Width del controllo btnAnima- 
te da un valore di partenza uguale a 100 fino ad ar- 
rivare a 200 in un periodo di tempo pari a 2 se- 
condi. Tornando al nostro orologio, dovremmo 
semplicemente definire tre animazioni, una per 
ogni lancetta e, naturalmente, andare ad interve- 
nire sulla proprietà Angle della trasformazione de- 
finita precedentemente. 

<!— Animazioni delle lancette — > 
<Window.Triggers> 
<EventTrigger RoutedEvent="Canvas.Loaded"> 
< BeginStoryboard > 
<Storyboard> 
<DoubleAnimation Storyboard.TargetName= 

"xformHour" 
Storyboard.TargetProperty= "Angle" 
From="0" To="360" Duration = "12:0:0" 
IsAdditive="True" 
RepeatBehavior="Forever" /> 



<DoubleAnimation Storyboard.TargetName= 

"xformMinute" 

Storyboard.TargetProperty= "Angle" 

From="0" To="360" Duration = "l:0:0" 

IsAdditive="True" 

RepeatBehavior="Forever" /> 
<DoubleAnimation Storyboard.TargetName= 

"xformSecond" 

Storyboard.TargetProperty= "Angle" 

From="0" To="360" Duration = "0:l:0" 

IsAdditive="True" 

RepeatBehavior="Forever" /> 



</Storyboard> 
</BeginStoryboard> 
</EventTrigger> 
</Window.Triggers> 



Ogni lancetta effettuerà, quindi, una rotazione di 360 
gradi ognuna della durata corrispondente ossia la 
lancetta dei secondi in 60 secondi, dei minuti in 60 mi- 
nuti mentre la lancetta delle ore in 12 ore. 
Volendo, possiamo anche eliminare il bordo e sfon- 
do standard della finestra attraverso le proprietà Win- 
dowStyle, AllowsTransparency e Background del- 
l'oggetto Window: 

WindowStyle="None" AllowsTransparency ="True" 
Background ="Transparent" 

Vito Arconzo 




uni po' di 

MATEMATICA 

La classe 

MatrixTransf orm crea 
una trasformazione 
matematica matrice 
usata per manipolare 
oggetti o coordinate in 
un piano 2D. Maggiori 
approfondimenti 
all'indirizzo 
http://msdn2. microsoft. 
com/en-us/librarv/svstem. 
windows.media.matrix 
transform.aspx. 




VITO ARCONZO 

sviluppa applicazioni 
sia Windows Forms 
che Web basate sul 
Microsoft .NET 
Framework già dalle 
prime versioni beta. In 
questo momento ciò 
che lo appassiona 
maggiormente è il 
nuovo engine 
introdotto con la 
versione 3.0 del .NET 
Framework, Windows 
Presentation 
Foundation e, tra le 
altre cose, collabora 
con lo User Group 
DotNetSide 
(www.dotnetside.org) 
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Una raccolta di trucchi da tenere a portata di... mouse 



I trucchi del mestiere 



Tips & TVicks 

Questa rubrica raccoglie trucchi e piccoli pezzi di codice, frutto dell'esperienza di chi programma, che solitamente non 
trovano posto nei manuali. Alcuni di essi sono proposti dalla redazione, altri provengono da una ricerca su Internet, altri 
ancora ci giungono dai lettori. Chi volesse contribuire, potrà inviare i suoi Tips&Tricks preferiti. Una volta selezionati, 
saranno pubblicati nella rubrica. Il codice completo dei tips è presente nel CD allegato nella directory \tips\o sul Web 
all'indirizzo: cdrom.ioprogrammo.it. 



POWERSHELL 

RILEVARE I CODEC AUDIO 
E VIDEO INSTALLATI 

Questo piccolo script consente di rilevare le informazioni 
che riguardano i codec audio e video installati sul siste- 
ma. Come qualcuno potrà facilmente verificare analiz- 
zando la classe Win32_CodecFile, tali dati non sono gli 
unici che risulta possibile ottenere. Quelli mostrati sono 
quelli che potrebbero tornarci maggiormente utili. Per 
una lista esaustiva di tutte le informazioni della classe 
sopraccitata, è possibile riferirsi al link http://windows- 
sdk. msdn.microsoft.com/en- us/library/ms 753639. aspx 

$strComputer = "." 
$Conteggio = 

Function ListaCodec 

{ 
param([string]$GroupType) 

# Imposta la stringa che funge da filtro 
$Filtro="Group = '$GroupType'" 

# Definisci la query che consente di estrarre le informazioni 

riguardanti i codec installati 
$colItems = get-wmiobject -class "Win32_CodecFile" - 

namespace "root\CIMV2" 
-filter $Filtro -computername $strComputer 

write-host "ELENCO CODEC $GroupType" 

ForEach ($objItem in $colItems) 
{ 

$Conteggio = $Conteggio + 1 



write-host "Nome: " $objItem.Name 



write-host 



write-host "Descrizione: " $objItem.Description 
write-host "Data installazione: " $objItem.InstallDate 
write-host "Manufacturer: " $objItem.Manufacturer 



write-host "Percorso: " $objItem.Path 



write-host "Versione: " $objItem.Version 



} 



write-host 



write-host "TOTALE CODEC RILEVATI: $Conteggio" 



write-host 



# Elenca le informazioni sui codec video 



ListaCodec "Video" 



# Elenca le informazioni sui codec audio 



ListaCodec "Audio" 

ATTENDERE 

LA DISTRUZIONE 

DI UHI PROCESSO 

Con uno script PowerShell è piuttosto banale controllare 
quando un processo viene distrutto. Tutto quello che 
occorre fare è definire il nome del processo da tenere 
sott'occhio ed utilizzare la WaitForExitQ . In questo esem- 
pio, abbiamo preso in considerazione il processo Task 
Manager. Per poterlo controllare, viene dapprima letta la 
variabile di ambiente SystemRoot per identificare il giusto 
percorso dell'applicativo e, successivamente, dopo aver- 
lo lanciato attraverso la cmdlet Invoke-Item, si raggiunge 
l'obiettivo prefissato. 

# Leggi la variabile SystemRoot e memorizzala 
$PathToWindows = $Env:SystemRoot 

# Crea il path completo della sottocartella System32... 
$PathToApplication = $PathToWindows + "\System32" 

# Lancia il processo Task Manager 
Invoke-Item "$PathToAppl ication\taskmgr.exe" 

# Imposta la variabile che indica il processo Task Manager da 
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controllare 



$ProcessoDaControllare = get-process taskmgr 

# Attendi che il processo venga chiuso per poter inviare un 

messaggio a video 
clear 

write-host "Chiudi la finestra Task Manager per visualizzare 

un messaggio." 



$ProcessoDaControllare.WaitForExit() 



# Visualizza il messaggio 



clear 



write-host "Il processo Task Manager è stato distrutto. Lo 

script può continuare!" 

TENERE SOTTO CONTROLLO 
L'AGGIORNAMENTO 

Questo script consente di tenere sotto controllo l'aggior- 
namento dei file contenuti all'interno di una qualunque 
cartella. Esso può tornare utile per controllare, ad esem- 
pio, se ci sono file di log che non vengono aggiornati ad 
intervalli di tempo predefiniti (nell'esempio abbiamo 
considerato ogni 30 minuti). In particolare, l'istruzione 
(get-date).AddMinutes(-$INTERVAL) consente calcolare 
la data e l'ora corrispondente a 30 minuti prima del 
momento in cui lo script viene lanciato. Si osservi, infine, 
che esistono altrettanti metodi per aggiungere/togliere 
ore, giorni, anni, ecc. definiti analogamente come 
AddHours, AddDays, AddYears, ecc. 



If($FSO.GetExtensionName($FileTrovato.Name) -eq 

$Estensione) 



{ 



# Controlla la data di ultima modifica e l'ora che non 







superiore a 


INTERVAL 


# 


Il parametro ' 


n" della DateDiff specifica e 
differenza è espressa 


he la 

in MINUTI 






If($FileTrovato 


DateLastModified -le (get- 

date).AddMinutes(-$INTERVAL)) 


{ 


# Scatta allarme 


write-host $FileTrovato.Name 


} 


} 


} 



UTILIZZARE L'OGGETTO 
INTERNET EXPLORER 

La PowerShell consente di referenziare ed utilizzare 
oggetti COM. Per far questo ci si serve della New-Object 
che, come vedremo, risulta relativamente semplice da 
utilizzare. In quest'esempio, apriremo una finestra 
Internet Explorer ed imposteremo alcune sue proprietà. 
In particolare, attraverso l'istruzione $Int Explorer\get- 
member possiamo visualizzare a video l'elenco di tutte le 
proprietà e dei metodi supportati. 



# Preleva tutti i files nella directory C:\LOG aventi l'estensione 

desiderata 

$FSO = new-object -com Scripting. FileSystemObject 
$folderObject = $FSO.GetFolder("C:\LOG") 
$filesObject = $folderObject. Files 



$Estensione = "txt" 



# Definisci un intervallo di controllo (per esempio 10 min.) 



$INTERVAL = 10 



# Dalla collection files controlla se ci sono file aventi 

l'estensione desiderata 

# Stampa l'elenco dei file che non sono stati aggiornati 

nell'intervallo specificato 
write-host "ELENCO FILE NON AGGIORNATI" 

# Un risultato analogo lo si poteva ottenere anche mediante il 

seguente comando, opportunamente 



# modificato in base alle esigenze: 



# dir "$folderObject\*.txt"| where-object 

{ $_.LastWriteTime -gè 
(get-date).AddMinutes(-$INTERVAL) } 



ForEach($FileTrovato In $FilesObject) 



{ 



# Se ci sono file con l'estensione scelta 



# Crea il nuovo oggetto 



$IntExplorer = New-Object -ComObject 

InternetExplorer. Application 

# Elenchiamo tutti i metodi e le proprietà dell'oggetto 
write-host "Elenco delle proprietà dell'oggetto 

INTERNET.APPLICATION" 
write-host 



$IntExplorer|get-member 



write-host 



"^^jC^jK^^^jC^^^^^jC^^^^^^^^^^^^jC^^c^^^jC^jK^^c^jC^c^^c^c^cj):^;^^" 



# Utilizziamo alcuni dei metodi e delle proprietà 



# Impostiamo la pagina web 



$IntExplorer.Navigate( "http://www.ioProgrammo.it") 



# Attiva la finestra a Full Screen 



$IntExplorer.Visible = l 



$IntExplorer.FullScreen = 



# Posiziona la finestra di Internet Explorer 
$IntExplorer.Top = 
$IntExplorer.Left=0 



# Fa sparire la barra dei menu 



$IntExplorer.MenuBar=0 
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UN MIGRATORE 
DI DATI UNIVERSALE 

VI E' MAI CAPITATO DI IMPLEMENTARE IL VOSTRO PROGRAMMA SU UN SISTEMA DI PROVA 
E DOVERLO POI IMPLEMENTARE IN UN SISTEMA IN PRODUZIONE? LA MIGRAZIONE DELLA 
STRUTTURA DATI POTREBBE NON ESSERE COSÌ SEMPLICE. ECCO UN PICCOLO AIUTO... 




U CD LI WEB 

TableSQLzip 



rrjy 7 ' ' ■ ' ■' 



W 




M 



Visual Studio 2005, SQL 
Server 2005 



0000' 



Quante volte ci è capitato di voler trasferire 
il contenuto di tabelle da un database ad 
un altro e non abbiamo potuto (o voluto) 
utilizzare strumenti automatici come le funzioni 
di importazione ed esportazione dati di SQL Server? 
In quante occasioni ci troviamo a dover importa- 
re (anche più volte nella stessa giornata) dei dati in- 
seriti nelle nostre tabelle da un database di svi- 
luppo ad uno di produzione o viceversa? 
Il programma che svilupperemo nel corso di que- 
sto articolo può risultare molto utile in queste si- 
tuazioni. 

La funzione principale del software che andremo 
a realizzare è la seguente: leggere il contenuto di 
una tabella di SQL Server e generare uno script T- 
SQL per l'insert dei dati in una tabella/database di 
destinazione. 

Prendiamo come esempio la tabella in figura: 
Nel corso dell'articolo vedremo come sia possibi- 
le realizzare un programma in grado di generare 
uno script di questo tipo: 



nostra disposizione. 



/table - dbo.Categories \ Table - dbo.Regions \ Summary 




catjd cat_short_name catjiame 


► 


telefonia Telefonia 




2 audio Audio 




3 video Video 


* 


MAL MAL MAL 



Fig. 1: La tabella da esportare 



SET IDENTITYJNSERT [categories] ON 
INSERTINTO [categories] ([catjd], [cat_short_na 
me], [cat_name]) VALUES (1, 'telefonia', 'Telefonia') 
INSERTINTO [categories] ([catjd], [cat_short_na 

me], [cat_name]) VALUES (2, 'audio', 'Audio') 
INSERTINTO [categories] ([catjd], [cat_short_na 

me], [cat_name]) VALUES (3, 'video', 'Video') 
SET IDENTITYJNSERT [categories] OFF 

Utilizzeremo delle tabelle e delle viste di sistema 

di SQL Server ed un po' di fantasia. . . 

Vediamo, innanzitutto, quali sono gli strumenti a 



E VISTE TABLES 

SQL Server memorizza in alcune tabelle di siste- 
ma tutte le informazioni sulla struttura del data- 
base, sulle tabelle che abbiamo creato (con relati- 
ve colonne), sulle viste, stored procedure e fun- 
zioni -tanto per citare qualche esempio. 
Per quanto riguarda le tabelle abbiamo due pos- 
sibilità; la prima: 

SELECT [Name] AS TABLE_NAME 

FROM sysobjects 

WHERE 

[type] = 'u' 

ORDER BY [Name] 

Legge i dati dalla vista di sistema "sysobjects". Fil- 
trando i dati per type = 'u' ci vengono restituite sol- 
tanto le tabelle utente. 

Useremo i seguenti valori per identificare il tipo di 
oggetto che ci interessa: 

• U: tabelle utente 

• P: Stored procedure 

• TR: Trigger 

• V: viste 

• PK: chiavi primarie 

• C: vincoli 

• D: defaults 

• F: chiavi esterne 

Per quanto riguarda le colonne possiamo utilizza- 
re due oggetti syscolumns per le colonne, systypes 
per ottenere il tipo di dato della colonna. 

SELECT 

syscolumns. [name] AS COLUMNJNAME, 

systypes. [name] AS DATAJTYPE 
FROM syscolumns 
INNER JOIN sysobjects 
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ON syscolumns.id = sysobjects.id 



SELECT C0LUMI\I_NAME, 



INNERJOIN systypes 



ON syscolumns.xtype = systypes. xtype 
WHERE sysobjects.[name] = 'Products' 

Un altro metodo è utilizzare le viste INFORMA- 
TION SCHEMA. 



Ad esempio, la INFORMATION JSCHEMA.TABLES 

restituisce la lista delle tabelle mentre la INFOR- 
MATION _SCHEMA.ROUTINES restituisce la lista 
di stored procedures e funzioni. 

Per visualizzare la lista delle tabelle, scriveremo: 

SELECT TABLEJMAME 

FROM INFORMATION_SCHEMA.TABLES 

WHERE TABLE_TYPE = 'BASE TABLE' 

ANDTABLE_NAME <> 'sysdiagrams' 
ORDER BY TABLE_NAME 

Mentre per le colonne della singola tabella: 

SELECT 

COLUMN_NAME, 

DATA_TYPE 

FROM INFORMATION_SCHEMA.COLUMNS 
WHERE 

table_name = 'Products' 



In questo ultimo esempio scorriamo le tabelle del 
nostro database e per ogni tabella trovata stam- 
piamo a video nome e tipo di tutte le colonne. 

DECLARE @TABLE_NAME NVARCHAR(128), 



@COLUMN_NAME 



NVARCHAR(128), 



@DATA_TYPE IWARCHAR(128) 



Scorriamo le tabelle 



DECLARE curTable CURSOR FOR 



SELECT TABLE_NAME 



FROM INFORMATION_SCHEMA.TABLES 
WHERE TABLE_TYPE = 'BASE TABLE' 
ANDTABLE_NAME <> 'sysdiagrams' 
ORDER BY TABLE_NAME 
OPEN curTable 



FETCH NEXT FROM curTable INTO @TABLE_NAME 



WHILE @@FETCH_STATUS = 
BEGIN 



PRINT @TABLE_NAME 

PRINT ''t 1 ***********************' 



— Scorriamo le colonne della tabella 
DECLARE curColumns CURSOR FOR 



DATA_TYPE 



FROM 
INFORMATION_SCHEMA.COLUMNS 



WHERE 



table_name = @TABLE_NAME 



OPEN curColumns 



FETCH NEXT FROM curColumns 
INTO @COLUMN_NAME, @DATA_TYPE 

WHILE @@FETCH_STATUS = 
BEGIN 



PRINT @COLUMN_NAME 
+ ': ' + @DATA_TYPE 



FETCH NEXT FROM 
curColumns INTO @COLUMN_NAME, @DATA_TYPE 



END 



CLOSE curColumns 



DEALLOCATE curColumns 



PRINT ' 



PRINT ' 



FETCH NEXT FROM curTable INTO 

@TABLE_NAME 



END 



CLOSE curTable 



DEALLOCATE curTable 



Adesso abbiamo le conoscenze di base per scrive- 
re il nostro software, mettiamoci all'opera! 



IL PROGETTO 

Creiamo un nuovo progetto di tipo "Console Ap- 
plication" con Visual Studio e chiamiamolo "Ta- 
blesToSQLDemoVB". 

Creiamo il file di configurazione 'App.config" e de- 
finiamo due parametri: la stringa di connessione al 
database (in cui dovrete inserire il nome del vostro 
server), ed un parametro "queryType" che farà uti- 
lizzare al programma gli oggetti schema oppure gli 
oggetti sys in base al suo valore. 
Trovate il file nel CD allegato. 
Apriamo il file Modulel.vb che rappresenta l'en- 
try point del programma. 
Dichiariamo due variabili globali: 

Dim queryType As String 
Dim Conn As SqlConnection 

la prima è legata al parametro dell'App.config, la 




IL CODICE 
ALLEGATO 

Gli esempi nell'articolo 
sono in Visual Basic; 
per chi fosse 
interessato, nel CD 
allegato è presente 
tutto il codice sorgente 
anche in C#. 
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.net 



seconda contiene la connessione al database. 
Analizziamo il Mairi: 

Sub Main(ByVal args() As String) 

queryType = 
ConfigurationManager.AppSettings("databaseVersion") 

Dim connectionString As String = "" 

' vedo se ho passato dei parametri al programma 
If (args.Length = 2) Then 

Dim server As String = args(0) 'primo 

parametro: il server 
Dim catalog As String = args(l) 'secondo 

parametro: il catalogo 



connectionString = _ 



"Data Source=" & server i 



;Initial Catalog=" & catalog &_ 



;Integrated Security=True"" provider 

Name=""System.Data.SqlClient" 



Else 



connectionString = _ 



ConfigurationManager.ConnectionStrings("Connection 
String"). ConnectionString 



End If 



istanzio la connessione 



Conn = New SqlConnection(connectionString) 



' Aspetto un comando 



Dim fullCommand As String 



Do 



Console. Write("$$$ ") 



fullCommand 



Console. ReadLine().ToLower().Trim() 



ExecuteCommand(fullCommand) 



Loop While (fullCommand <> "quit") 
End Sub 

La prima parte del metodo legge i parametri dal- 
l' App.config ed istanzia la connessione. 
Se abbiamo passato due parametri alla riga di co- 
mando, i nomi del database e del server vengono 
letti da questi, altrimenti dal file di configurazio- 
ne. Dopo aver istanziato la connessioni, il pro- 
gramma si comporta come un listener, restando 
in attesa di un comando. 

La funzione ExecuteCommand legge il nostro co- 
mando e lo interpreta; il funzionamento è sempli- 
ce e non lo analizzeremo nel corso dell'articolo. Il 
codice è comunque presente nel CD allegato in- 
sieme a resto del progetto. 



VISUALIZZIAMO LE 
TABELLE DEL DATABASE 

Analizziamo la funzione che ci permette di otte- 
nere la lista delle tabelle: 



j System Views 






CRI\5QL2005\Databases\Produd:s\V 


iews\5ystem Views 




Name 


Schema 


Created 


1 Ep CHECK_CON5TRAINT5 


INFORMATION SCHEMA 


14/10/2005 


Et COLUMN_DOMAIN JJ5AGE 


INFORMATION_5CHEMA 


14/10/2005 


COLUMN_PRMLEGES 


INFORMATION SCHEMA 


14/10/2005 


Et COLUMNS 


INFORMATION SCHEMA 


14/10/2005 


CONSTRAINT_COLUMN_USAGE 


INFORMATION SCHEMA 


14/10/2005 


CON5TRAINT_TABLE_U5AGE 


INFORMATION SCHEMA 


14/10/2005 


DOMAIN_CON5TRAINT5 


INFORMATION_SCHEMA 


14/10/2005 


DOMAINS 


INFORMATION SCHEMA 


14/10/2005 


KEY_COLUMN_USAGE 


INFORMATION SCHEMA 


14/10/2005 


PARAMETERS 


INFORMATION SCHEMA 


14/10/2005 


REFERENTIAL_CON5TRAINT5 


INFORMATION SCHEMA 


14/10/2005 


ROUTINE_COLUMN5 


INFORMATION_SCHEMA 


14/10/2005 


ROUTINES 


INFORMATION SCHEMA 


14/10/2005 


SCHEMATA 


INFORMATION SCHEMA 


14/10/2005 


TABLE_CONSTRAINT5 


INFORMATION SCHEMA 


14/10/2005 


TABLE_PRIVILEGE5 


INFORMATION SCHEMA 


14/10/2005 


TABLE5 


INFORMATION SCHEMA 


14/10/2005 


0J VIEW_COLUMN_USAGE 


INFORMATION SCHEMA 


14/10/2005 


01 VIEW_TABLE_USAGE 


INFORMATION SCHEMA 


14/10/2005 


| 0J VIEWS 


INFORMATION_SCHEMA 


14/10/2005 



Fig. 2: Le tabelle di sistema che memorizzano 
la struttura del DB 



Private Sub ListTables() 

Dim tablesList As List(Of String) = getTablesList() 

For Each table As String In tablesList 
Console. WriteLine(table) 

Next 

Console. WriteLine("") 
End Sub 



Private Function getTablesList() As List(Of String) 

Dim tablesList As List(Of String) = New List 

(Of String) 
Try 

Conn.OpenQ 



Dim Comm As SqlCommand 



New SqlCommandO 



Comm. Connection = Conn 



Comm.CommandText = GetTablesSQL() 

Dim Reader As SqlDataReader = 

Comm.ExecuteReaderO 



Try 



While Reader. Read() 



TablesList.Add(Reader("TABLE_NAME"). 

ToStringO) 



End While 



Finally 



Reader.Close() 



End Try 



Finally 



Conn.Close() 



End Try 



Return TablesList 



End Function 



La funzione ListTables istanzia una lista e la po- 
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pola tramite la getTablesList, poi stampa a video i no- 
mi delle tabelle. 

La funzione TablesList utilizza la GetTablesSQL 
per ottenere la query da eseguire al fine di recu- 
perare la lista delle tabelle ed un DataReder per 
popolare la lista con i nomi delle tabelle. 
Ecco il codice: 

Private Function GetTablesSQL() As String 
If query Type = "schema" Then 

Return "SELECTTABLEJMAME" &_ 

" FROM INFORMATION_SCHEMA.TABLES" & 



" WHERE TABLE_TYPE = 'BASE TABLE"' &_ 
" ANDTABLE_NAME <> 'sysdiagrams'" &_ 
" ORDER BY TABLE_NAME" 
Else 

Return "SELECT [Name] AS TABLEJMAME" &_ 



Dim f As StreamWriter = Nothing 



FROM sysobjects" & _ 



WHERE" &_ 



[type] 



'u'" &. 



ORDER BY [Name] 



End If 



End Function 

Per testare la funzione, al prompt digitiamo "list" e 
premiamo invio. 



CREIAMO GLI SCRIPT 

Se al prompt digitiamo "sql:nometabella", viene 
lanciata la funzione GenerateSQL, che genera lo 
script SQL contenente le istruzioni di insert per 
scrivere i dati nella tabella. 
Vediamo come funziona: 

Private Sub GenerateSQL(ByVal arrCommand() As 

String) 
Dim tableColumns As List(Of TableColumn) 
Dim sqlScripts As List(Of String) 



'1. Lettura parametri 
Dim paramsNumber As Integer = 

arrCommand.Length - 1 
If paramsNumber < 1 Then 

Console. WriteLine("list: nome tabella mancante") 

Return 
End If 
If paramsNumber > 1 Then 

Console. WriteLine("list: troppi parametri") 

Return 
End If 



f = File.CreateText(fileName) 



'3. generazione script 



Try 



Conn.Open() 



If (TableExists(Conn, tableName)) Then '3.1. 

verifico l'esistenza della tabella 



'3.2. lettura colonne 



tableColumns = GetColumnList(tableName, 

Conn) 

'3.3. lettura dati e preparazione script 
sqlScripts = GetSQLStatements(tableName, 

Conn, tableColumns) 

'3.4. scttura dati 
SaveSQLScript(tableName, fileName, f, 

sqlScripts) 

Else 

Console. WriteLine("sql: tabella inesistente") 
Return 
End If 
Finally 

'rilascio risorse 
Conn.Close() 
f.CIose() 
End Try 

'4. apertura file 

System. Diagnostics.Process.Start(fileName) 
End Sub 



Lettura parametri 



generazione script 



lettura colonne (GetColumnList) 



lettura dati e preparazione script (GetSQLStatements) 
INSERT INTO [TABELLA] 



Ciclo lettura nomi colonne 



n 



VALUES 



Ciclo lettura valori colonne 



n 



scttura dati (SaveSQLScript) 




SYSTEM. 

COLLECTIOIMS. 

GENERIC 

È un nuovo namespace 
introdotto con .Net 2.0. 
Contiene i "Generics" 
delle collection 
tipizzate molto potenti 
e perf ormanti. 
Nel programma 
abbiamo utilizzato 
le List, delle liste 
tipizzate. 

La forza dei generics 
risiede nel fatto che, 
conoscendo a priori 
il tipo di dato che 
contengono, non sono 
necessarie 

le operazioni di boxing 
ed unboxing che erano 
invece indispensabili, 
ad esempio, con gli 
ArrayList, i cui 
elementi sono degli 
object. 



'2. nome tabella e file su cui salvare lo script 
Dim tableName As String = arrCommand(l) 
Dim fileName As String = tableName & ".txt" 



Visualizzazione file 



Fig. 2: Flow Chart del metodo 
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Come prima cosa leggiamo il parametro rappre- 
sentante il nome della tabella da esportare; creia- 
mo quindi il file su cui salvare lo script. 
Lo step di generazione script: 

• verifica l'esistenza della tabella da esportare 

• legge quali sono le colonne della tabella 

• legge i dati dalla tabella e prepara lo script 

• salva lo script su file 

Analizziamo i passi significativi uno alla volta. 
Tralasciamo la funzione di verifica esistenza ta- 
bella, molto semplice - comunque presente nel CD 
allegato. 

Per la lettura ed il salvataggio in memoria della li- 
sta delle colonne utilizziamo una classe interna. 

Private Class TableColumn 

Private _COLUMN_NAME As String 



Public ReadOnly Property COLUMN_NAME() As 



String 



Get 



Return _COLUMN_NAME 



End Get 



End Property 



Private _DATA_TYPE As String 



Public ReadOnly Property DATA_TYPE() As String 



Get 



Return _DATA_TYPE 



End Get 



End Property 



Public Sub New(ByVal COLUMNJMAME As String, 

ByVal DATA_TYPE As String) 
_COLUMN_NAME = COLUMNJMAME 



_DATA_TYPE = DATA_TYPE 



End Sub 
End Class 

Ci consentirà di memorizzare in una lista ge- 
nerica le coppie di valori "nome colonna" / "ti- 
po di dato". Vediamo la funzione GetColumn- 
List che legge i nomi delle colonne e li salva in 
una lista. 

Private Function GetColumnl_ist(ByVal tableName As 

String, ByVal Conn As SqlConnection) As List(Of 

TableColumn) 
Dim tableColumns As List(Of TableColumn) = New 

List(Of TableColumn) 

Dim Comm As SqlCommand = New SqlCommand() 
Comm. Connection = Conn 
Comm.CommandText = GetColumnsSQL 

(tableName) 



Dim Reader As SqlDataReader = 

Comm.ExecuteReader() 
Try 

Do While (Reader.Read()) 

tableColumns. Add(New TableColumn 

(Reader("COLUMN_NAME").ToString(), _ 
Reader("DATA_TYPE").ToString())) 



Loop 



Finally 



Reader.Close() 



End Try 



Return tableColumns 



End Function 

Viene istanziata una lista generica List<TableCo- 
lumn> di oggetti di tipo TableColumn, gli elemen- 
ti vengono quindi aggiunti alla lista tramite un Da- 
taReader che legge il risultato della query. 
Per utilizzare le liste generiche è necessario im- 
portare un namespace: System.Collection.Gene- 
rics 

Private Function GetColumnsSQL(ByVal tableName As 

String) As String 
If query Type = "schema" Then 
Return "SELECT" &_ 

" COLUMN_NAME," &_ 
" DATA_TYPE" & _ 

" FROM INFORMATION_SCHEMA.COLUMNS" 

&_ 
" WHERE" &_ 

" table_name = "' + tableName + '"" 
Else 

Return "SELECT" &_ 

" syscolumns.[name] AS COLUMN_NAME," 

" systypes.[name] AS DATA_TYPE" &_ 

" FROM syscolumns" &_ 

" INNER JOIN sysobjects" &_ 

" ON syscolumns. id = sysobjects. id" &_ 



" INNER JOIN systypes" &_ 

" ON syscolumns. xtype = systypes. xtype" & 
" WHERE sysobjects. [name] = "' + tableName + '"" 
End If 
End Function 



Vediamo quindi la funzione che prepara lo script: 

Private Function GetSQLStatements(ByVal tableName 
As String, ByVal Conn As SqlConnection, ByVal table 
Columns As List(Of TableColumn)) As List(Of String) 

Dim sqlScripts As List(Of String) = New List 

(Of String) 
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Dim Comm As SqlCommand = New SqlCommand() 
Comm. Connection = Conn 
Comm.CommandText = "SELECT * FROM " 

& tableName 

Dim Reader As SqlDataReader = 

Comm.ExecuteReader() 
Try 



Do While (Reader.Read()) 



Dim sbSQL As StringBuilder ■■ 



New StringBuilder() 



sbSQL.Append("INSERT INTO 

[" & tableName &"] ") 



'colonne 



Dim sbColumns As StringBuilder = New 

StringBuilder() 
For Each te As TableColumn In tableColumns 



sbColumns. Append("[" & tc.COLUMN_NAME 

&"],") 

Next 

sbColumns. Remove(sbColumns.Length - 2, 2) 



sbSQL. Append(" (") 



sbSQL.Append(sbColumns) 



sbSQL. Append(") ") 



sbSQL.Append(" VALUES ") 



'valori 



Dim sbColumnVaules As StringBuilder = New 

StringBuilder() 
For Each te As TableColumn In tableColumns 
sbColumnVaules.Append(FormatInput 

(Reader(tc.COLUMN_NAME), _ 



tc.DATA_TYPE) + ", ") 



Next 



sbColumnVaules. Remove(sbColumnVaules. 

Length - 2, 2) 



sbSQL. Append(" (") 



sbSQL.Append(sbColumnVaules) 



sbSQL. Append(") ") 



sqlScripts.Add(sbSQL.ToString()) 



Loop 



Finally 



Reader.Close() 



End Try 



Return sqlScripts 



End Function 



La funzione restituisce una lista di stringhe, cia- 
scuna delle quali è un'istruzione SQL. Osser- 
viamo come funziona: 



Viene eseguita la query che restituisce il conte- 
nuto della tabella. Si cicla, quindi, il DataReader 
con i valori e, per ogni riga, si costruisce la query. 

sbSQL.Append("INSERT INTO [" & tableName & "] ") 

fornisce la prima parte dell'insert. 

Viene poi ciclata la lista delle colonne per scrivere 

i nomi dei campi: 

For Each te As TableColumn In tableColumns 

sbColumns.Append("[" &tc.COLUMN_NAME & "], ") 
Next 

Inseriamo, quindi, la scritta VALUES e poi i valori 
ciclando ancora sulle colonne: 

For Each te As TableColumn In tableColumns 
sbColumnVaules. Append(FormatInput(Reader( te. 

COLUMN_NAME), _ 
tc.DATA_TYPE) + ", ") 
Next 

Nello scrivere i valori, utilizziamo la funzione For- 
matlnput, che formatta la stringa di input in base 
al tipo di dato della colonna. 
Dopo aver generato lo script, la funzione Save- 
SQLScript, si occupa di salvare su file i contenuti. 
Una particolarità della funzione in questione è da- 
ta dalla seguente istruzione: 

f.WriteLine("SET IDENTITYJNSERT [" & tableName & 

"] ON") 

la quale dice a SQL Server che si possono inserire 
esplicitamente i valori dei campi identity. 



CONCLUSIONI 

Abbiamo visto come sia possibile ricavare in mo- 
do abbastanza semplice le informazioni sugli 
oggetti dei nostri database. 
È meglio usare i SYSOBJECTS oppure le viste TA- 
BLES? Le informazioni che possiamo ottenere 
sono praticamente le stesse. 
Le TABLES, rispetto ai SYSOBJECTS mostrano 
soltanto gli oggetti su cui l'utente ha i permessi; 
inoltre fanno parte di uno standard e sono quin- 
di, a mio avviso, da preferire. 
In ogni caso i metodi illustrati possono risulta- 
re molto utili nella migrazione dei dati quando le 
procedure standard non si atdattano alla nostra 
struttura, o quando la migrazione deve avveni- 
re fra sistemi che hanno un diverso approccio 
alla gestione dei database. 

Carmelo Scuderi 
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APACHE DERBY: IL 
DATABASE TASCABILE 

UNA PANORAMICA SUL DATABASE RELAZIONALE SCRITTO INTERAMENTE 

IN JAVA E RECENTEMENTE INTEGRATO DA SUN MICROSYSTEMS NELL'ULTIMA 

VERSIONE DEL JDK. MOLTO COMODO PER LE SUE RIDOTTE DIMENSIONI 



■gflHi O 



Li CD LI WEB 

Apachederby.zip 



VL 




7 Basi di Java, Basi di 
!S Standard SQL 
(Structured Query 
Language) 



M 



Java 2 Standard Edition 
SDK 1.3 o superiore - 
Apache Derby 10.2.2.0 




uando ci si trova a realizzare un progetto 
software di qualsiasi tipo, ci si pone spesso 
il quesito di come memorizzare i dati per poi 
successivamente recuperarli e/o elaborarli. Svi- 
luppare personalmente una soluzione per risol- 
vere questo problema risulterebbe molto dispen- 
dioso e richiederebbe conoscenze avanzate. Nella 
maggior parte dei casi questa incombenza viene 
affidata a prodotti di terze parti: i database rela- 
zionali. Scegliere una base dati conforme allo stan- 
dard SQL (Structured Query Language) rappresenta 
un vantaggio notevole in quanto tale notazione, 
oltre ad essere riconosciuta universalmente come 
strumento di manipolazione dati, minimizza o an- 
nulla gli sforzi nel momento in cui si decida di cam- 
biare RDBMS. Nello sviluppo Java, la tecnologia 
JDBC rende semplice ed intuitivo l'invio di co- 
mandi SQL ad un database relazionale in grado di 
comprendere tale "dialetto". Una delle novità pre- 
senti nell'ultima versione della Virtual Machine di 
Sun Microsystems è proprio l'integrazione con un 
database relazionale: Java DB. Non si tratta di un pro- 
dotto realizzato dal team di James Gosling ma di 
una ri- distribuzione, "marchiata Sun", del proget- 
to open source Apache Derby. Nel prosieguo del- 
l'articolo vedremo come utilizzarlo al meglio de- 
scrivendone le principali funzionalità. 



APACHE DERBY 

Le origini di Apache Derby risalgono al 1996, 
allora sotto il nome di JBMS. Successivamente 
fu ribattezzato Cloudscape e infine, dopo l'ac- 
quisizione da parte di IBM nel 2004, venne 
incluso nel progetto Derby di Apache. Fin dalle 
prime versioni, il database si dimostrò prodot- 
to valido e funzionale, tanto da suscitare l'inte- 
resse di un colosso mondiale quale IBM. Negli 
anni successivi tante funzionalità furono 
potenziate e implementate, ma significative 
migliorie furono apportate quando il progetto 
diventò open source e solo grazie alla parteci- 



pazione della community che è stato possibile 
raggiungere il livello di stabilità e robustezza 
che oggi lo contraddistingue. Da un punto di 
vista tecnico è possibile tradurre questi dieci 
anni di sviluppo in un database engine com- 
pletamente realizzato in Java eseguibile in due 
differenti modalità: embedded o client- server. 



O CLIENT-SERVER 

La scelta della modalità da utilizzare è stretta- 
mente dipendente dalla tipologia di applica- 
zione su cui ci troviamo a lavorare. Nel caso in 
cui l'applicazione faccia un uso esclusivo del 
database diventa preferibile utilizzare Derby in 
versione embedded: l'engine è eseguito all'in- 
terno della stessa JVM utilizzata dall'applica- 




É indispensabile avere installato sul computer 
Java 2 Standard Edition SDK 1.1 o superiore. 
É preferibile utilizzare l'ultima versione dispo- 
nibile dal sito http://java.sun.com. 
Scaricare lo zip file contenente il database 
Apache Derby dal sito http://db.apache.org 
/derby lderby__downloads.html. 
É possibile installare il database, indipenden- 
temente dalla piattaforma sulla quale sarà 
utilizzato, estraendo il contenuto dell'archivio 
scaricato sul file system. 
La cartella db-derby-<version>-bin sarà creata 
automaticamente. Il "cuore" del sistema ri- 
siede nel file derby.jar contenuto nella direc- 
tory lib. Per l'utilizzo all'interno di un deter- 
minato progetto è necessario dichiararlo nel 
CLASSPATH del progetto stesso. La documen- 
tazione risiede nella cartella docs ed è fruibile 
nei formati HTML e PDF. 
Una volta completata la fase di installazione 
del database è possibile eseguire lo script 
sysinfo per visualizzare le proprietà e l'am- 
biente in cui Derby verrà eseguito. 
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zione. La caratteristica principale di questa 
opzione risiede nell'elevata velocità di esecu- 
zione: i dati non hanno infatti bisogno di esse- 
re convertiti e spediti in rete come avviene 
nelle comunicazioni di tipo client-server. 
Ovviamente una sola applicazione (o, meglio, 
JVM) per volta può effettuare l'accesso a que- 
sto tipo di base dati (vedi Figura 1). 



Java Virtual 
Machine 



JDBC T 




Fig. 1: Schema d'uso di Apache Derby in modalità 
embedded. 



Di seguito è riportato il codice necessario ad ot- 
tenere una connessione ad un'istanza embed- 
ded: 



// carico il driver di tipo embedded 



try { 



Class. forName( 

"org.apache. derby .jdbc. Embedded Driver"); 
} catch (ClassNotFoundException cnfe) 



{ 



System. err.println("Unable to load jdbc driver: 

" + cnfe.getMessage()); 



} 



Connection conn = nuli; 



try {// ottengo la connessione 



conn = DriverManager.getConnection( 

"jdbc: derby :ìoProgrammoDB;create=true"); 
SQLWarning warnìng = conn.getWarnings(); 
if (warning != nuli) { // cerca eventuali avvertimenti 
System. out.println("WARNING: " + warning); 



} 



} 



catch (SQLException se) 



{ 



System. err.println("Unable to retrieve connection: 
" + se.getMessage()); 



} finally { 



if (conn != nuli) { 



try { 



conn.close(); 



} catch(SQLException se) { /* empty */ } 



L'URL standard per questa modalità è identifica- 
to dalla stringa: 

jdbc:derby:[databaseName]. 

Inoltre, come riportato nel codice di esempio, è 
possibile inserire una serie di attributi separati 
dal delimitatore ";" (punto e virgola). Nel nostro 
caso, l'URL è stato completato con l'aggiunta del 
parametro create la cui funzione è quella di crea- 
re automaticamente la base se non esiste. In caso 
contrario viene assegnato alla connessione un 
oggetto di tipo java.sql.SQLWarning contenente 
un apposito avviso. 

La modalità client-server (vedi Figura 2) viene 
generalmente utilizzata quando si vuole garanti- 
re un accesso multi utente sia locale sia remoto. 
L'interoperabilità con il database engine, che 
confronto alla precedente opzione rimane inva- 
riato, viene gestita da un server che utilizza il 
protocollo standard DRDA (Distributed Relatio- 
nal Database Architecture) attraverso cui è possi- 
bile comunicare con applicazioni scritte con dif- 
ferenti linguaggi (PHP Perl, .NET). 



Java Virtual 




Fig. 2: Schema d'uso di Apache Derby in modalità 
client-server. 



Non ci resta che avviare il database server. Per far 
questo è necessario eseguire lo script startNet- 
workServer presente nella directory di installa- 
zione di Derby all'interno del folder bin. Per crea- 
re una nuova base dati e stabilire una connessio- 
ne remota alla stessa è possibile utilizzare lo stes- 
so codice riportato per la modalità embedded, 
sostituendo la classe del driver con org.apache 
.derby.jdbc.ClientDriver e l'URL con jdbc:derby: 
//[hostName]:1527/ioProgrammoDB;create=true, 
dove hostName rappresenta il nome o l'indirizzo 
IP della macchina su cui è stato avviato il server. 
Di seguito riportiamo un metodo di esempio che, 
indipendentemente dalla modalità utilizzata, 
inserisce un record rappresentante un libro nella 
tabella BOOKS e ne stampa a video l'intero con- 
tento: 




PRINCIPALI 
CARATTERISTICHE 
DI APACHE 
DERBY 

• Scritto interamente 
in Java 

• Dimensioni ridotte, 
buone prestazioni 
ed affidabilità 

• Nessun limite 
applicativo sulle 
dimensioni del database 

• Facile da usare, non 
richiede amministrazione 

• Supporto per triggers 
e Java stored procedures 

• Supporto transazionale 
di tipo ACID (Atomicity, 
Consistency, Isolation, 
Durability) 

• Indipendente 
dalla piattaforma 

• Supporta gli standard 
J2MEICDCIFoundation 
Profile (JSR-1 69) 

• Utilizzabile in modalità 
embedded o client-server 

• La portabilità 
è garantita 

• Compatibile agli 
standard ANSI-92 SQL 
e JDBC 3.0 

• Il codice sorgente 
è disponibile 
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public void execute(int id, String title, String author, 

int pages) 

1 

Connection conn = this.getConnection(); 
if (conn != nuli) 



{ 



Statement stmt = nuli; 



boolean create = false; 



try { 



stmt = conn.createStatement(); 



stmt.executeQuery("select * from BOOKS"); 



} catch (SQLException se) { 



create = true; 



try { 



if (create) { 



System. out.println("La libreria non esiste 
... creiamola"); 
stmt.execute("create table BOOKS 

(ID integer, TITLE varchar(256), 
AUTHOR varchar(512), PAGES integer)"); 



} 



stmt.execute("insert into BOOKS values 

("+id+", " +"'"+title+"', " + 
""'+author+'" ," + pages+")"); 
System. out.prìntln("La libreria contiene:"); 
ResultSet rs = stmt.executeQuery("select * 
from BOOKS"); 



while(rs.next()) { 



System. out.println(); 



System. out.println("ID : 

" + rs.getObject("ID")); 
System. out.println("TITOLO : 

" + rs.getObject("TITLE")); 

System. out.println("AUTORE : 

" + rs.getObject("AUTHOR")); 
System. out.println("PAGINE : 

" + rs.getObject("PAGES")); 



} 



} catch(SQLException se) { 



se.printStackTrace(); 



APPLICAZIONI WEB: 
DAL SERVER AL CLIENT 

Con il Web 2.0 e l'evoluzione delle tecnologie ad 
esso associate, prima tra tutte AJAX, le applica- 
zioni web hanno preso la tendenza di trasferire 
una buona parte della logica applicativa dal ser- 
ver al client (il web browser). Una limitazione 
particolarmente sentita dagli utenti è il fatto che 
tali applicazioni web necessitano di una connes- 
sione internet sempre attiva. Una soluzione a 
questo problema è quella di affiancare l'applica- 
zione con un database eseguito sul browser stes- 
so. Già da qualche tempo Mozilla sta analizzando 
la possibilità di equipaggiare Firefox con un db 
SQLite. Le difficoltà di integrazione sono relative 
al pesante utilizzo di risorse necessarie ad ese- 
guire un database engine. Grazie alle sue caratte- 
ristiche, Derby si candida come valida soluzione 
a questo problema: il db è contenuto in un unico 
file e, a tempo di esecuzione, consuma all'incirca 
2MB di memoria. Per "trasportare" il database 
dal server al client è possibile utilizzare una 
comune applet: 

<APPLET CODE="DerbyLocalStoreApplet. class" 

CODEBASE="./ioProgrammo" WIDTH = 1 HEIGHT= 

1 NAME="DerbyLocalStore" 

ARCHIVE="derby.iar"x/APPLET> 

L' engine è contenuto nel file derby.jar mentre 
l'applet DerbyLocalStoreApplet si occuperà della 
sua gestione. Nel metodo init(), facente parte del 
ciclo di vita dell' applet, implementeremo la fase 
di inizializzazione del database: 

public void inìt() { 

Connection conn = nuli; 
Statement stmt = nuli; 

System. out.prìntln("Inizializzazione 

del database locale"); 

ds = new EmbeddedDataSource(); 
// step di creazione del database 



TRAIMSAZIOMALITA IN PILLOLE 



Quando si inizia l'analisi ed 
il disegno architetturale di 
un progetto software ci 
trova spesso a scegliere la 
base dati su cui si dovrà 
successivamente lavorare. 
Questa scelta è vincolata 
dalle caratteristiche imple- 
mentate dai vari vendor. 
Un'importante funzionalità, 
soprattutto nei progetti su 



piattaforma enterprise, è il 
supporto alla transaziona- 
lità. È importante però 
sapere che esistono vari li- 
velli di transazionalità rias- 
sumibili dall'acronimo ACID: 

• ATOMICITÀ: garantisce che 
una serie di operazioni con- 
tigue appaiano come una 
singola unità di lavoro. 



CONSISTENZA: garantisce 
che, alla fine di ogni 
transazione, lo stato del 
sistema sia consistente. 

ISOLAMENTO: permette 
l'esecuzione concorrente 
di più transazioni in modo 
del tutto trasparente alle 
varie transazioni coinvol- 
te, garantendo che ogni 



transazione sia appunto 
isolata dalle altre. 

DURABILITÀ: garantisce 
che, in caso di malfunzio- 
namenti (interruzione 
della comunicazione, 
crash del disco rigido), le 
risorse in fase di 
aggiornamento non 
vadano perdute. 
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d< 


.setCreateDatabase("create"); 




ds 


.setDatabaseName("ioProgrammoDB"); 




try { 


conn = ds.getConnectionQ; 




} 


catch (SQLWarning sqle) { 






System. out.println("II database 

ioProgrammoDB è già presente . 


■"); 


ds.setCreateDatabase(null); 


} 


catch (Exception ex) { 






System. err.println("ERRORE: Impossibile 
connettersi al database ioProgrammoDB: 
ex.getMessage 


" + 

O); 


retu rn ; 


} 


// 


creazione della struttura del db 






try { 


stmt = conn.createStatement(); 




stmt.execute("CREATE TABLE BOOKS 

(ID integer, TITLE varchar(256) 
" AUTHOR varchar(512), PAGES integer 


" + 
)"); 


} 


catch (SQLException e) { 






System. out.println("La tabella BOOKS 

già presente . 


■"); 


try{ 


stmt.closeO; 


conn.closeO; 


return; 


}catch (Exception ex) { /** empty */ } 


} 


} 



In questo frangente è stato utilizzato l'oggetto 
EmbeddedDataSource contenuto in Apache 
Derby. A fronte di particolari interazioni uten- 
te lato browser sarà sufficiente richiamare al- 
tri metodi, implementati all'interno della no- 
stra applet, che andranno ad operare sulla ba- 
se dati locale. Per ottimizzare il tempo di 
download dell'applet contenente la libreria 
derby.jar è consigliabile utilizzare pack200, un 
tool, contenuto nella JDK dalla versione 5.0, 
che consente di diminuire la dimensione dei 
Jar files (http:lljava. 

sun.com/j2se/1.5.0/docs/guide/deployment 
Ideployment-guide Ipack200.html) . 



RMS ADDIO? 

In un precedente articolo di ioProgrammo ab- 
biamo parlato del Record Management Sy- 
stem, il sistema standard di persistenza dati 
presente su piattaforma J2ME con profilo 
MIDP 2.0. Tale tecnologia consente la memo- 



rizzazione e la successiva lettura di record in 
formato binario. Le funzionalità di questo si- 
stema sono relativamente "grezze", pertanto 
viene solitamente utilizzato per applicazioni 
di piccole dimensioni. 

Molti dispositivi di nuova generazione, equi- 
paggiati con configurazione CDC (Connected 
Device Configuration), saranno in grado di 
eseguire TAPI JDBC standard senza sacrificar- 
ne alcuna funzionalità. Viste le sue caratteri- 
stiche di database "tascabile" Apache Derby 
potrà essere utilizzato come base dati locale 
anche su tali dispositivi. 



CONCLUSIONI 

Apache Derby è un database relazionale i cui 
primi sviluppi risalgono all'anno 1996. Da 
allora la community open source ha apporta- 
to importanti migliorie sia in termini di fun- 
zionalità che di robustezza. Gli ottimi risultati 
di questi anni di lavoro sono stati ulterior- 
mente confermati dalle scelte fatte da IBM e 
Sun Microsystems di includere il database nei 
prodotti Cloudscape e Java DB. La maggior 
parte delle caratteristiche che lo contraddi- 
stinguono fanno si che esso venga considera- 
to nello sviluppo di varie di tipologie di pro- 
getto. 

I punti di forza che hanno accresciuto la sua 
popolarità risiedono nelle ridotte dimensioni 
e nel limitato utilizzo di risorse a tempo di 
esecuzione. 

Queste evoluzioni rappresentano una vera e 
propria rivoluzione per gli sviluppatori, in 
quanto consentono lo sviluppo di applicazio- 
ni con basi di dati locali su dispositivi mobili e 
browser web. 

Fabrizio Fortino 




NETBEANS + DERBY 



La maggior parte degli ambienti di svilup- 
po presenti sul mercato offrono funziona- 
lità per interfacciarsi in maniera visuale 
con un database generico tramite la 
tecnologia JDBCIODBC. Visti gli stretti 
"legami" tra la community di 
Netbeans e Sun Microsystems, l'ambiente 
di sviluppo è stato corredato (dalla 
versione 5.5) con un'apposita feature per 
la gestione di Derby/JavaDB. Nel CD 
allegato è disponibile un tutorial interat- 
tivo che descrive l'integrazione dei due 
prodotti, accessibile dal file 
flash tutoriallderby 
4-netbeans.html. 
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IL C++ INCONTRA LE 
REGULAR EXPRESSION 

NON SI PUÒ SERIAMENTE PARLARE DI TEXT PROCESSING, SENZA TRATTARE ANCHE 

LE ESPRESSIONI REGOLARI. È VERO CHE IL C++ NON SUPPORTA LE REGEX? E QUALI SONO 

LE LIBRERIE CHE PERMETTONO DI SUPERARE IL PROBLEMA? 




o 




REQUISITI 



■«.M.»jj.kimmff 

— Buona conoscenza del 

JS- c++ 



Un compilatore C++ 
standard 




Eccoci al terzo appuntamento col mondo del 
text processing. Nei primi due abbiamo in- 
cominciato dalle fondamenta, analizzando 
come il C++ definisce internamente il concetto di 
carattere e di stringa; come è possibile concatena- 
re e formattare stringhe usando gli stream stan- 
dard, format e lexical_cast; e infine come mani- 
polare le stringhe attraverso gli algoritmi standard 
e le estensioni di string_algo. 
Oggi siamo in grado di spostarci ancora più avan- 
ti, parlando della validazione e delle stringhe. Con 
questo termine s'intende la verifica della loro ade- 
sione ad uno specifico modello formale. I pro- 
grammatori si trovano comunemente a dover va- 
lidare delle stringhe; come esempio basti pensare 
agli indirizzi e-mail, ai codici fiscali, e ai numeri di 
carta di credito. 

Ne sappiamo certamente abbastanza per realiz- 
zare a mano tutte queste routine di controllo, usan- 
do le funzionalità che abbiamo imparato negli ul- 
timi articoli, ma l'impresa può rivelarsi molto com- 
plessa: ci vuole poco a sconfinare nella creazione 
di veri e propri automi a stati finiti, difficili da scri- 
vere, leggere e manutenere. 
La maggior parte dei programmatori, invece, co- 
nosce già - almeno per sentito dire - una soluzio- 
ne comoda, potente e versatile: le espressioni regolari 
(altrimenti dette regex). Ecco, ad esempio una sem- 
plice regex per la validazione di una carta di cre- 
dito. 

(\d{4}[-/\s]*){4} 

Posso immaginare la vostra reazione. Se avete già 
avuto a che fare con le regex, la analizzerete per 
due secondi pensando "sì, può andare. Anche se 
forse può essere fatta meglio in questo modo...". 
Se non avete mai programmato con le regex, inve- 
ce, questo semplice esempio può già sembrare to- 
talmente incomprensibile. Non potendo sapere a 
quale categoria apparteniate, supporrò che non 
sappiate niente delle espressioni regolari. 
Alla fine di quest'articolo, saprete costruire delle 
regex di media complessità. Capirete perfettamente 



l'esempio posto qui sopra (e molti altri), e saprete 
utilizzarlo praticamente nel vostro codice C++. 



IL C++ E LE REGEX 

Le regex sono un argomento fortemente pratico. 
È molto facile scriverne una sbagliata, o che si com- 
porta in maniera imprevista, soprattutto quando si 
sta ancora imparando - ma perfino gli esperti van- 
no spesso a tentativi. Sarebbe quindi auspicabile co- 
minciare a spiegare le regex direttamente sul cam- 
po, con del codice C++ pronto per essere testato. 
Purtroppo, ciò presume che il C++ supporti in qual- 
che modo le regex nativamente - e non è così. Lo 
standard non dice assolutamente nulla a riguar- 
do, e questa è certamente una delle omissioni più 
gravi della libreria del C++. Chi volesse scrivere 
qualcosa di "standard" oggi potrebbe solo appog- 
giarsi alle funzioni POSIXregcomp, regexec, ecce- 
tera. Queste funzioni sono limitate, scomode, e di 
tipica impostazione C, qualcosa da evitare assolu- 
tamente nella programmazione C++. 
Non è quindi una sorpresa che tanti programma- 
tori abbiano cercato di colmare le lacune del C++ 
scrivendo una bella libreria che si occupasse di ge- 
stire le espressioni regolari. I tentativi sono stati 
molti, più o meno riusciti. Fra i migliori, non si pos- 
sono non segnalare almeno Regex++ di John Mad- 
dock e GRETA di Eric Niebler. Regex++, in partico- 
lare, è stato adottato dalla comunità C++ più au- 
torevole: boost ed è ad oggi una delle librerie più sca- 
ricate e usate dell'intera suite. 
Il bisogno di un'implementazione standard per le 
regex in C++ ha portato alla stesura di un propo- 
sai nel TRI, basato proprio su regex++. Questo si- 
gnifica, in parole povere, che il C++ del futuro 
(C++09) avrà con tutta probabilità un supporto 
standard per le regex la cui interfaccia sarà molto 
affine a quella già fornita da boost::regex. 
Una volta esaurite le premesse possiamo cominciare 
installando gli strumenti che ci servono. Le regex pos- 
sono sembrare leggermente complesse ma tutto 
diventa semplice dopo il primo approccio. 
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INSTALLARE 
BOOST::RECEX 

Per tutti i motivi esposti nei paragrafi precedenti, 
presenterò boost::regex come la soluzione C++ al- 
le regex. Se volete seguire l'articolo, quindi, dovre- 
te installare la libreria e configurare l'ambiente e 
gli eventuali IDE. In tutti i nostri precedenti ap- 
puntamenti boost ci ha sempre trattato molto be- 
ne, richiedendoci l'unico sforzo di includere de- 
gli header. 

Le regex, purtroppo, sono un caso particolare in 
cui oltre alle inclusioni dei file header è necessa- 
rio compilare i sorgenti in una libreria. Fino a qual- 
che tempo fa, boost era nota per non essere trop- 
po amichevole in fase di installazione; oggi, per 
fortuna, le cose vanno diversamente. Nei passi che 
seguono vedremo che installare boost::regex è 
un'impresa relativamente semplice sia in Linux 
che in Windows. Per sapere dove reperire librerie e 
componenti, fate riferimento ai box laterali. 

1 Scaricate la libreria boost, e mettetela in una 
cartella temporanea (come "C:\tmpBoost", o 
"/tmpBoost"). 



I Scaricate boost-jam. 



riga di: 

bjam "-sTOOLS=vc-8_0" instali 

e fatevi una lunga passeggiata, in attesa che ter- 
mini la compilazione. 



6 



Impostate le librerie nell'IDE 



Per Linux, impostate il vostro IDE in modo da pas- 
sare al compilatore (anche) la direttiva -lboost_re- 
gex-gcc-l_33_l. 

Per Windows, aggiungete alle directory di inclu- 
sione del vostro IDE "C:\Boost\Include\boo- 
st_l_33_l\" e a quelle di libreria "C:\Boost\Lib". 



7 



Cancellate la cartella temporanea (rimuovendo 
/tmpBoost o C:\tmpBoost) 



Complimenti! Avete ora un'installazione comple- 
ta di boost a portata di mano (in /usr/ o in C:\Boo- 
st), che vi permetterà di usare non solo le regex, 
ma anche ogni altra meraviglia fornita da boost! 
Qui ho illustrato due percorsi possibili e basilari. 
Se doveste avere problemi o necessità particolari, 
consultate i riferimenti forniti sui box laterali per l'in- 
stallazione con boost-jam o via makefile. 




BOOST.ORG 

Boost è "la" comunità 
C++ per quanto 
riguarda le estensioni 
alla libreria standard. 
L'indirizzo è 
www.boost.org. da 
dove si può scaricare 
liberamente l'intera 
libreria. 



Per Linux, questa viene fornita come pacchetto 
rpm precompilato: vi consiglio di approfittarne. 
Per Windows, scaricate la versione ntx86.zip di 
boost-jam e decomprimetela in C:\tmpBoost. 

3 Se siete sotto Windows, assicuratevi di avere in- 
stallato Visual Studio 2005 Express (IDE ottimo 
e gratuito), e il Platform SDK, e compiuto tutti i 
passi necessari alla loro configurazione (vedi box 
laterale). 

4 Accedete al prompt dei comandi e portatevi 
nella directory di boost. 
Per linux, la cosa è banale: entrate in un termina- 
le qualsiasi, e digitate ed /tmpBoost. 
Per Windows, assicuratevi di accedere al termina- 
le fornito dal Platform SDK sul menu d'avvio, che 
permette di avere tutte le variabili d'ambiente cor- 
rettamente configurate; digitate "ed C:\tmpBoo- 
st". 

r~ Compilate. 

Per Linux, inviate un comando sulla falsariga di: 

bjam "-sTOOLS=gcc" instali — prefix=/usr 

e aspettate che termini la compilazione. 

Per Windows, inviate un comando sulla falsa- 



BOOST:: BASIC REGEX 

Ora che abbiamo installato boost::regex possiamo 
fare la nostra prima prova: 

#include <iostream> 
#include <boost/regex.hpp> 

using namespace std; 
using namespace boost; 

int main() 

{ 
regex r("ciao!"); 
cout << regex_match("ciao!", r); 

return 0; 
} 

Questo programma stamperà 1, e ora vedremo per- 
ché. Innanzitutto notiamo l'inclusione dell'hea- 
der <boost/regex.hpp>, e della direttiva using na- 
mespace boost, che ci evita di dover ogni volta ri- 
correre al prefisso boost::. 

Quindi, entriamo nel vivo con la riga regex r("ciao!"). 
Stiamo costruendo un oggetto r, di tipo regex. boo- 
st::regex è un typedef definito così: 

typedef boost: :basic_regex<char> boost: :regex; 



BOOST: :REGEX 

Le informazioni 
"ufficiali" su 
boost::regex si 
trovano all'indirizzo 

http://www.boost.org/libs 
/regex/doc/index.html . 
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BOOST-JAM 

La maniera migliore 

per costruire le librerie 

di Boost è Boost-Jam: 

un sistema di makefile 

cross-platform. 

L'indirizzo è: 

http://sourceforqe.net/ 

project/showfiles.php? 

group id=7586&package 

id=72941. 



Se avete seguito lo scorso appuntamento, questo non 
vi suonerà nuovo: anche la classe string è definita 
in modo molto simile: 

typedef std: :basic_string<char> std: :string; 

Regex è in effetti molto simile a string, perché ri- 
calca l'interfaccia dei contenitori standard. Esi- 
stono regex e wregex, proprio come esistono string 
e wstring. 

La stringa passata nel costruttore di boost::regex 
(in questo caso, "ciao!") è la regex vera e propria. 
Una volta definita, è possibile ottenere l'oggetto 
corrispondente come std::string, attraverso la fun- 
zione str(): 

regex r("ciao!"); 
string s(r.str()); 

Ovviamente, una regex non ha molto senso come 
contenitore alternativo a string fine a sé stesso. Lo 
scopo di una regex è fungere da modello in base al 
quale, poi, si effettueranno delle validazioni: nel- 
l'esempio ciò viene svolto dall'algoritmo re- 
gex_match(testo_da_validare, regex) . 



CASE SEIUSITIVITY 

Nel caso più banale, una stringa viene considera- 
ta valida rispetto ad una regex solo se è identica ad 
essa. Ciò spiega perché nel nostro codice di esem- 
pio regex_match restituisce true, e quindi viene 
stampato a schermo il valore "1". Da questo pun- 
to di vista, la chiamata a regex_match potrebbe es- 
sere sostituita da un semplice confronto con un 
oggetto string: 

cout << (string("ciao!") == r.str()); // 1 

Proprio come gli oggetti string, le regex sono ca- 
se-sensitive, e pertanto se nel nostro esempio ci li- 
mitiamo anche solo a cambiare una maiuscola, re- 
gex_match ci restituirà inesorabilmente false: 



regex_match("ciao!", r); //true 



regex_match("CIAO!", r); //sempre true!! 



CLASSI DI CARATTERI 



Finora le regex non sono state granché esaltanti. 
Per fare un primo salto di qualità dobbiamo co- 
minciare a fare distinzione fra varie "classi". Una 
"classe" è nel gergo delle regex un insieme di ca- 
ratteri, come ad esempio quello delle cifre, dei ca- 
ratteri maiuscoli, degli spazi, dei caratteri alfanu- 
merici. Le classi più importanti sono indicate in 
tabella 1, sia nella loro versione posix "estesa" che 
nelle rispettive abbreviazioni con i backslash. 



Significato 


Classe 


Breve 


Qualsiasi carattere 
(tranne i ritorni a capo) 


[ A \r\n] 




Cifre 


[[:digit:]] o [0-9] 


\d 


Qualsiasi carattere 
tranne le cifre 


[ A [:digit:]]o[ A 0-9] 


\D 


Lettere Maiuscole 


[[:upper:]] o [A-Z] 


\u 


Qualsiasi carattere 
tranne le maiuscole 


[ A [:upper:]] o [ A A-Z] 


\U 


Lettere Minuscole 


[[:lower:]] o [a-z] 


\1 


Qualsiasi carattere 
tranne le minuscole 


[ A [:lower:]]o[ A a-z] 


\L 


Spazio 


[[:space:]] o [ 
\t\n\r\f\v] 


\s 


Qualsiasi carattere 
tranne gli spazi 
Carattere di parola 


[ A [:space:]] o[ A \s] 


\S 


(alfanumerici + 
underscore) 


[[:word:]] o [\u\l\dj 


\w 


Qualsiasi carattere 
tranne uno di parola 


[ A [:word:]]o 
[ A \u\l\dJ 


\W 


.Tabella 1: Classi predefinite di caratteri. 



Per indicare l'ingresso di un numero a quattro ci- 
fre, ad esempio, si può scrivere la regex: 



regex r("ciao!"); 



regex_match("Ciao!" r); // false 

Una simile distinzione non è sempre desiderabile. 
Qui comincia a sorgere una prima differenza con 
gli oggetti string: il costruttore di regex prevede un 
secondo parametro, all'interno del quale è possi- 
bile combinare dei flag che permettono di modifi- 
care i requisiti della regex. Uno dei più importan- 
ti è icase, che rende i confronti case insensitive. 

regex r("ciao!", regex: : icase); //regex case 

insensitive 



\d\d\d\d 

Ed ecco il corrispondente programma per la vali- 
dazione: 



int main() 


{ 


regex r("\\d\\d\\d\\d"); 


cout << regex_ 


_match(' 


1234' 


, r); 


//true 


cout << regex_ 


_match(' 


123", 


r); 


//false! 




return 0; 


} 
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È importante che notiate il doppio backslash al- 
l'inizio dei quattro "\\d". Ciò è una logica conse- 
guenza del fatto che in C++ il backslash è un ca- 
rattere speciale, che serve a introdurre i caratteri 
di escape (come il famosissimo \n, per andare a 
capo), e che per essere scritto testualmente dev'es- 
sere a sua volta preceduto da un backslash (tradu- 
zione: per scrivere \ in una stringa C++, bisogna 
scrivere \ \) . 

A tanta confusione si aggiunge anche il fatto che 
pure le regex hanno i loro caratteri riservati, chia- 
mati metacaratteri, e cioè .[{()\*+?| A $. 
Prendetevi un po' di tempo per capire le implica- 
zioni di tutto questo: se volete scrivere quattro ci- 
fre seguite da un punto, ad esempio, dovrete scri- 
vere questa regex: 

\d\d\d\d\. 

che corrisponde, però, a questo codice C++, con i 
doppi backslash: 

regex r("\\d\\d\\d\\d\\."); 

Potete verificare se avete capito bene quanto visto 
finora, analizzando questa regex: 

regex r("\\d\\\\\\d"); 

Che tipo di espressione può essere validata da que- 
sta regex? La stringa 2 \3 è valida? Perché? 



CLASSI DI CARATTERI 
COMPOSTE 

Oltre alle classi di carattere predefinite, è possibi- 
le indicare qualunque insieme di caratteri attra- 
verso l'uso delle parentesi quadre. La regex: 

\d[abc]\d 

ad esempio, valida qualsiasi stringa costituita da 
una cifra, un carattere a scelta fra 'a', 'b' e 'e', e 
un'altra cifra. Ad esempio, la stringa: " la2" è senz'al- 
tro valida. La stringa 2dl non lo è, perché 'd' non fa 
parte della classe [abc]. 

Per snellire la specifica delle classi, spesso è co- 
modo fare riferimento ai range. Poniamo di svi- 
luppare un engine scacchistico, e di voler validare 
una coppia di coordinate della scacchiera. Voglia- 
mo permettere stringhe come "al", "b8", "h5", ma 
non "x9", o altri codici senza senso. Con le classi 
composte possiamo scrivere: 

[abcdefgh][12345678] 

ma è una scrittura un po' prolissa. Usando dei ran- 



ge con la sintassi [inizio-fine] , possiamo ridurre il 
tutto a: 

[a-h][l-8] 

Le due scritture sono del tutto equivalenti. 
Infine, come si può vedere dalla stessa tabella 1, 
può essere molto utile usare l'operatore di nega- 
zione ' A '. Se si vuole evitare che l'utente inserisca 
un carattere non-italiano, ad esempio, si può usa- 
re il gruppo: 

[^jkwxy] 



QUANTIFICATORI 

Le regex usate finora pongono un po' di problemi, 
soprattutto per il fatto che sembrano orientate ai sin- 
goli caratteri più che alle stringhe: ipotizziamo di 
dover validare un codice di 16 cifre, come quello 
di una comune carta di credito. Potremmo scrive- 
re qualcosa del genere: 

\d\d\d\d\d\d\d\d\d\d\d\d\d\d\d\d 

Ma è davvero possibile che non esista la notazione 
ripeti per sedici volte? C'è, ovviamente, ed è questa: 

\d{16} 

Le due scritture sono assolutamente equivalenti, {n} 
è un quantificatore che convalida la stringa solo 
se l'espressione che lo precede si trova ripetuta 
esattamente n volte. Dalla tabella 2, che mostra i 
principali quantificatori, scopriamo anche che pos- 
siamo scrivere il codice così: 

\d{15, 16} 

Questa scrittura permette di trattare anche quelle 
carte di credito che hanno quindici cifre, e non so- 
lo quelle che ne hanno sedici. Il quantificatore {n, 
m}, infatti, valida la stringa solo se l'espressione 
che lo precede è ripetuto almeno n volte, e al più m 
volte. Sempre dalla tabella 2, scopriamo anche 
un'altra notazione sorprendente: 

\w{6, } 

Potremmo usare questa regex per chiedere all'u- 
tente di inserire una password di almeno 6 carat- 
teri. Il quantificatore {n, }, infatti, valida la stringa 
solo se l'espressione che lo precede è scritta alme- 
no n volte. Questa scrittura è ancor più potente di 
quanto appare, e fa fare alle nostre regex un bel 
salto di livello. È talmente utile che ha dato origine 
ai sinonimi *, +, e ?, mostrati nel resto della in tabella 




VISUAL C++ 
EXPRESS E 
PLATFORM 
SDK 

Su Windows consiglio 

caldamente 

l'installazione 

di Visual C++ Express 

2005 in congiunzione 

col Platform SDK. 

Per assicurarvi 

di installarli 

(e, soprattutto, 

configurarli) 

correttamente, seguite 

i semplici passi 

descritti 

a quest'indirizzo: 

http://msdn. microsoft. 

com/vstudio/express/ 

visualc/usinqpsdk/ 
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2, che si traducono rispettivamente in {0, }, {1, } e {0, 
1}. Ecco l'esempio della carta di credito, riveduto e 
corretto alla luce dei quantificatori: 



BIBLIOGRAFIA 

Una buona 

introduzione a 

boost::regex (e non 

solo) è fornita in 

"Beyond the C++ 

Standard Library, an 

introduction to boost" 

di Bjorn Karlsson. 

L'ottimo "The C++ 

Standard Library 

Extensions: A Tutorial 

and Reference" di Pete 

Becker dedica molti 

capitoli alle regex così 

come sono 

standardizzate nel TR1. 

L'intero testo è', in 

generale, un 

validissimo punto di 

riferimento per capire 

i vari proposai del TR1 

- che letti da soli sono 

molto sterili e poco 

accessibili. 

Per chi volesse 

approfondire 

l'argomento regex 

consiglio: "Mastering 

Regular Expressions" 

(seconda edizione) di 

Jeffrey E F Friedl. 

</BOX> 



regex r("\\d{4}[-/\\s]* 


\\d{4}[-/\\s]*\\d{4}[- 

A\s]*\\d{4}[-/\\s]*"); 




cout << 


regex_ 


_match( 


1234567890123456", r); 


//true 


cout << 


regex_ 


_match( 


1234-5678-9012-3456", r); 

//true 


cout << 


regex_ 


_match( 


1234 


- 5678 / 9012 /-/ 

3456", r); //true! 


cout << 


regex_ 


_match( 


123 - 


5678 - 9012 - 3451", 


r); 


//false! 



Mi rendo conto che l'impatto con la regex alla pri- 
ma riga potrebbe essere traumatico; non spa- 
ventatevi. Fate come fanno tutti gli esperti quan- 
do si trovano davanti ad un'espressione rego- 
lare: fate la faccia di quelli che: "sì, sì, è chiaris- 
simo" (salvare le apparenze è importante), e in- 
tanto scomponetela mentalmente pezzo per 
pezzo. Diventerà facile sul serio. Togliete prima 
i doppi backslash, riducendoli ad uno solo. 

\d{4}[-/\s]*\d{4}[-/\s]*\d{4}[-/\s]*\d{4}[-\s/]* 

Quindi analizzate la regex con calma: si richie- 
dono quattro numeri, seguiti da un carattere 
qualsiasi fra: - (il trattino), / (la slash), e \s (ov- 
vero tutti i caratteri di spazio). Questo insieme 
di caratteri è seguito dall'asterisco, che vuol di- 
re (tabella 2 alla mano) che può essere ripetuto 
zero o più volte. Poi il tutto si ripete uguale per 
altre tre volte. Questa regex serve quindi a va- 
lidare un insieme di quattro numeri, seguito da 
un insieme di separatori (/ -), per quattro volte. 
Ora potete capire molto meglio perché i primi 
tre match funzionano, e l'ultimo invece no. 



Quantificatore 


Sintassi 


Esattamente n volte 


{ni 


Da n a m volte (estremi compresi) 


{n,m( 


no più volte 


{n,l 


zero o più volte ({0, }) 


* 


una o più volte ({1, }) 


+ 


zero o una volta ({0, 1)) 


? 


.Tabella 2: Quantificatori. 



sere qualcosa del genere 

\d{4}[-/\s]*{4} 

L'idea è buona: ripetere quattro volte il gruppo "ci- 
fre più separatori". Peccato che non funziona: il 
quantificatore si applica solo all'ultimo elemento 
- quindi, in realtà stiamo "moltiplicando per quat- 
tro" soltanto [-/\s]*. Il che è sbagliato, e inutile. 
Per ripetere anche le cifre insieme ai separatori, 
dobbiamo usare le parentesi tonde, così: 

(\d{4}[-/\s]*){4> 

Ora il quantificatore si applica a tutto il "blocco" 
(\ d{4} [- / \ s] *) . Un' espressione inclusa fra parente- 
si tonde viene chiamata in gergo gruppo. I gruppi, 
come vedremo, giocano un ruolo fondamentale 
per le ricerche e i riferimenti. 



RICERCHE 

Finora abbiamo limitato la nostra attenzione alla 
funzione regex_match. Questa, come abbiamo vi- 
sto, restituisce true solo se si verifica una corri- 
spondenza perfetta fra la regex e la stringa da ana- 
lizzare. Ciò è utilissimo nei casi in cui si voglia va- 
lidare un testo, ma una regex può servire anche ad 
altro. L'algoritmo regex_search, ad esempio, può 
essere molto utile per implementare facilmente 
delle ricerche testuali con tutta la potenza degli 
strumenti più avanzati, come grep. Regex_search 
si comporta in maniera un po' diversa da re- 
gex_match: non richede una corrispondenza per- 
fetta, ma la cerca in mezzo alla stringa passata. 
Esempio: 



regex r("(\\d{4}[-/\\s]*){4}"); 


cout 


<< regex_ 


_match("000- 


1234567890123456", 


r); 


//false 


cout 


<< regex_ 


_search("000 


■1234567890123456", 


r); 


//true 



GRUPPI 

L'ultima regex è un po' lunga. La prima soluzione 
a cui verrebbe spontaneo pensare, potrebbe es- 



La regex della carta di credito viene ora utilizzata sul- 
la stringa "000-1234567890123456". Questa non 
corrisponde perfettamente alla regex, in quanto 
contiene tre caratteri iniziali, e non quattro come 
richiesto. Pertanto, regex_match svolge onesta- 
mente il suo lavoro restituendo false. Regex_sear- 
ch, invece, fa un passo in più, e cerca di andare 
avanti nella speranza di trovare prima o poi una 
corrispondenza. E ci riesce, perché dal quinto ca- 
rattere in poi ci sono sedici cifre, proprio come ri- 
chiesto dalla regex. Regex_search è quindi felice di 
restituire true! Questo sistema apre nuovi scena- 
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ri, nuove possibilità, (e, perché no, anche nuovi 
problemi) alle nostre regex. 



RICERCHE E RISULTATI 

Ora immaginiamo di essere degli odiosissimi spam- 
mer, sempre alla ricerca di nuovi strumenti per car- 
pire gli indirizzi e-mail degli ignari utenti che an- 
cora si ostinano a scriverli sulle pagine web. Pro- 
babilmente la nostra "stringa" consisterà in un'in- 
tera pagina HTML potenzialmente piena di indirizzi 
promettenti. Organizziamo una piccola regex sen- 
za pretese, per individuarli: 



typedef match_ 


_results<const char*> cmatch; 


typedef match_ 


_results<std::string: :const_iterator> 


smatch; 


typedef match_ 


_results<std::wstring::const_iterator> 
wsmatch; 



Come vedete, in questo caso abbiamo usato smat- 
ch, perché abbiamo dichiarato pagina come 
std::string. Se l'avessimo dichiarato come const 
char*, avremmo avuto bisogno di un cmatch, e co- 
sì via. La funzione regex_search che abbiamo ri- 
chiamato è diversa dall'ultima volta; ha tre argo- 
menti: il testo su cui effettuare la ricerca, l'oggetto 
in cui immagazzinare il risultato, e infine la regex. 




[\w\.]+@[\w\.]+\.\w+ 

II senso dovrebbe essere chiaro: "una parola (di al- 
meno un carattere o punto) ", seguita da una chioc- 
ciola, seguita da un'altra parola (di almeno un ca- 
rattere/punto) , seguita da un punto, seguita da una 
parola (di almeno un carattere). Non è molto ac- 
curata, ma non dimenticate chi siamo e quali so- 
no i nostri squallidi obiettivi. A questo punto pro- 
viamola su una semplice paginetta: 

regex r("[\\w\\.]+@[\\w\\.]+\\.\\w+"); 

string pagina("per informazioni scrivete a 

posta@robertoallegra.it... l'email di ioprogrammo è 
ioprogrammo@edmaster.it"); 

cout << regex_search(pagina, r); //true! 

Ok, regex_search restituisce true. Ma non ci serve 
a molto sapere se una pagina contiene o meno de- 
gli indirizzi email. Vogliamo sapere quali sono. Per 
questo, dobbiamo richiamare un overload di re- 
gex_search che ci permetta di aver accesso al ri- 
sultato della ricerca: 

//■■■ 

smatch result; 



if (regex_search(pagina, result, r)) 
cout << result; //posta@robertoallegra.it 

Ora regex_search stampa la nostra prima vittima: 
"posta@robertoallegra.it". Tutto grazie all'oggetto 
result, di tipo smatch, che serve a contenere i ri- 
sultati di una ricerca effettuata su un oggetto 
std::string (pagina). Smatch è, infatti, un typedef 
della classe generica match_results: 



template <class 


Iterator, 






class Allocator 


=std::allocator<sub_ 


^match<Iterator> 


> 


class match_ 


results; 








typedef match_ 


"esults<const wchar. 


_t> 


wcmatch; 



RISULTATI MULTIPLI 

Nel nostro esempio, però c'è un secondo indirizzo 
email che ci è sfuggito: ioprogrammo@edmaster.it. 
Evidentemente regex_search si ferma al primo ri- 
sultato trovato. Per accedere anche ai successivi 
dobbiamo utilizzare un ciclo, e ancora un nuovo 
overload di regex_search: 



//... 




string 


: const. 


Jterator it = 


vagina. begin(); 


string 


: const. 


Jterator end = 


= pagine 


.end(); 




while 


^regex_ 


_search(it, enc 


, result, 


r)){ 


cout 


<< result << endl; 






it = 


result. suffix(). first; 






} 



Ora il programma stampa entrambi gli indirizzi, 
uno dopo l'altro. È importante capire quel che sta 
succedendo. Abbiamo usato un overload di re- 
gex_search che prende non più un oggetto string, 
ma due iteratori, proprio come fanno solitamente 
gli algoritmi standard. Ogni volta che viene stam- 
pato un risultato, si incrementa l'iteratore it, pun- 
tandolo al primo carattere (first) di ciò che sta do- 
po il testo trovato (suffixO). Il ciclo continua, finché 
non vengono più trovate corrispondenze. 



RISULTATI E GRUPPI 

Ora sappiamo inserire gli indirizzi trovati in una pa- 
gina HTML nel nostro database di vittime. Possiamo 
fare di peggio? Certamente! Sarebbe bello scomporre 
gli indirizzi in modo tale da separarne le componen- 
ti fondamentali. Possiamo usare i gruppi, così: 

([\w\.]+)(@)([\w\.] + )\.(\w+) 

Così facendo abbiamo scomposto l'indirizzo in 
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quattro gruppi: username (1), chiocciola (2), do- 
minio (3), e dominio di primo livello (4). 



regex r("([\\w\\.]+)(@)([\\ 


*\\.]+)\\.(\\w+r); 


//... 




while (regex_search(it, end 


result, r)) { 




cout << 


"indirizzo:\t" << 


result[0] << 


endl 


<< 


'username:\t" << 


result[l] << 


endl 


<< 


'chiocciola:\t" << 


result[2] << 


endl 


<< 


'dominio:\t" << result[3] << endl 


<< 


'primolivello:\t" << result[4] << endl 


<< 


endl << endl; 






it = result.suffix(). first; 


} 



Come vedete dal codice qui sopra, gli oggetti di ti- 
po match_results sono utili anche come conteni- 
tori. Result[0] contiene l'intera corrispondenza tro- 
vata, e gli elementi dall' 1 in poi corrispondono ai 
singoli sottogruppi appena descritti. 



« 



Viiiii/jij - iSaitiila 



H 



Sessione Modifica Visualizza Segnalibri 
Impostazioni Aiuto 



indirizzo ; 
username: 
chiocciola: 
dominio: 
primolivello : 



indirizzo: 
username: 
chiocciola: 
dominio: 
primolivello : 



posta@robertoallegra. it 
posta 

e 

robertoallegra 
it 



ioprogrammo@edmas ter.it 
ioprogrammo 

e 

edmaster 
it 



Press Enter to continue! 



■P : /bin/sh 



L'AUTORE 



Figura 1: Scomposizione del testo in sottogruppi 
mediante regex_search e match_results 



regex r("([\\w\\.]+)(@|at| at )([\\w\\.]+)\\.(\\w+)", 

regex: :icase); 

Il gruppo della chiocciola, ora, comprende più al- 
ternative, separate dall'operatore pipe (|), che si 
comporta come un or logico. In result[2] potremo 
avere "@", "at", o " at ", a seconda dei casi. 



REGEX REPLACE 

L'ultima modifica ci crea un problema: sappiamo 
leggere un indirizzo con delle chioccioline finte ("at", 
" at "), ma non potremo mai usarlo per spedire la no- 
stra spazzatura. Prima di memorizzarlo nel nostro 
database dovremo quindi sostituire il secondo grup- 
po con una chiocciolina. 

Possiamo realizzare la cosa concatenando le strin- 
ghe che abbiamo trovato, in questo modo: 

string indirizzo = result[l] + "@" + result[3] + "." + 

result[4]; 

Questo risolve il problema: anche se result sarà "user- 
nameATdominio.com", indirizzo conterrà comun- 
que "username@dominio.com". Ma si tratta di una 
soluzione prolissa, un po' analoga alla concatena- 
zione via-stream che abbiamo visto nel primo articolo 
di questa serie. Grazie all'algoritmo regex_replace, 
possiamo unire i risultati in un testo di formattazio- 
ne, proprio come si fa nella creazione di stringhe con 
boost::format o sprintf: 

string indirizzo(result[0]); 

indirizzo = regex_replace(indirizzo, r, "$1@$3.$4")); 

Regex_replace prende in ingresso un testo da modi- 
ficare, una regex di partenza, e un testo di formato. 
Nel testo di formato ci si può riferire ai singoli sottogruppi 
con l'operatore $, permettendo così una scrittura estre- 
mamente compatta, e variabile. 



Il sito 

www.robertoallegra.it 

contiene l'elenco degli 

articoli pubblicati in 

questa rubrica, con gli 

inevitabili 

approfondimenti ed 

errata corrige. L'e-mail 

dell'autore è 

articoli@robertoallegra.it 



ALTERNATIVE 

Inspiegabilmente, alcuni utenti hanno incominciato 
a infastidirsi per la nostra onesta attività di spammer, 
e hanno escogitato una contromisura. Non scrive- 
ranno più il proprio indirizzo come "username@do- 
minio.com", malo altereranno leggermente, in modo 
che sia comprensibile per gli umani, ma non per la 
nostra regex. Scriveranno, ad esempio "usernameAT- 
dominio.com", oppure "username at dominio.com", 
eccetera. Che illusi! Abbiamo previsto la loro reazione, 
per questo abbiamo creato un gruppo fatto apposta per 
la chiocciolina. Ci basta modificarlo, così: 



CONCLUSIONI 

In quest'articolo abbiamo solo grattato la super- 
ficie delle possibilità offerte dalle espressioni re- 
golari e da boost::regex, e non potrebbe essere al- 
trimenti, dal momento che una trattazione completa 
richiederebbe un libro intero (come quelli mostrati 
in bibliografia). 

Il nostro viaggio nel text processing va avanti ver- 
so l'ultima puntata, in cui arriveremo a superare 
perfino le espressioni regolari, costruendo dei ve- 
ri e propri parser. Non mancate! 

Roberto Allegra 
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UN GENERATORE DI 
CLASSI VISUAL BASIC 

PROGETTIAMO UN GENERATORE AUTOMATICO A PARTIRE DA UNO SCHEMA XML. 
QUESTO GENERE DI APPLICAZIONE CI CONSENTE DI RISPARMIARE TEMPO. INOLTRE 
IMPAREREMO COME VB GESTISCE IL PARSINF DI FILE XML 



Uno studio su un possibile utilizzo 
dello scripting, è lo scopo di questo 
articolo. Tutto ciò per realizzare un 
generatore automatico di classi VBScript che 
rimappino la struttura di un file XML qualun- 
que, purché dotato di schema interno o ester- 
no. 



GLI SCHEMI XML 

Una interessante caratteristica dell'XML è la 
possibilità di verificare la correttezza seman- 
tica di un certo file rispetto ad un template 
standard di riferimento detto schema. Infatti 
l'XML è di per sé un formato piuttosto rigido, 
nel senso di garanzia di correttezza sintattica 
che prevede una lunga serie di regole da 
rispettare, perché il file XML si possa definire 
well formed. Queste vanno dal chiudere ogni 
tag che viene aperto, all'uso degli apici per i 
valori degli attributi, alla presenza di un solo 
nodo padre per ciascun file e tanto altro 
ancora. Non sarà argomento di questo artico- 
lo spiegare queste regole; la rete e le librerie 
sono ormai sature di materiale sull'XML. La 
verifica sintattica però non è tutto. Si è reso 
necessario definire un formato che descrives- 
se le regole semantiche a cui deve soggiacere 
il file perché possa essere universalmente 
compreso anche da chi non ne è l'autore. 
Proviamo ad immaginare di voler definire un 
formato standard per le fatture da condivide- 
re con i nostri clienti e fornitori, e per far ciò 
vogliamo basarci su XML. Dobbiamo specifi- 
carne la logica (es. un nodo di testata che si 
chiama HEADER, che contiene alcuni attri- 
buti come Number, Year e altri ancora, uno o 
più nodi di tipo ROW e così a continuare). Lo 
schema XML serve proprio a questo. In realtà 
gli schemi sono un'invenzione recente per 
l'XML: inizialmente il loro compito era svolto 
dai DTD (Document Type Definition) dalla 



logica molto simile. Gli schemi hanno, rispet- 
to ai loro antesignani, numerosi vantaggi: 
sono XML essi stessi, supportano l'eredita- 
rietà e sono molto più potenti e completi. 
Osserviamo questo esempio di file XML: 

<?xml version="1.0"?> 
<vCRM AUTHOR="Vito Vessia" 

mi ns:xsi = "http ://www. w3.org/2001/XM LSchema- 

instance" 
xsi:noNamespaceSchemaLocation = "F:\ScriptClasses\ 
XMLCIasses\disk\Untitled2.xsd"> 
<ORDER DONE_NODE = "FALSE" 

CODE_SITE = "JRHOLD" 
CODE_CORRESPONDENT="ARDILLO" 
CODE_INVOICE_CUST="029900" 

CODE_SHIP_CUST="029900" 
CODE_ORDER_"TYPE = "%" CODE_FAIR="COD_FIERA" 
CODE_PL_SOFA="AJ" CODE_PL_ACCESS = "EF" 

CODE_CURRENCY="ITL[~]" 
COD CAUS COMM="G03" 



COD_CAUS_PROD = 



'MAG" 

CODE_DOC_TYPE = "003"> 



<HEADER_REMARK 

HRMRK_CODE_SITE = "JRHOLD" 

HRMRK_PROGRES = "l" HRMRK_CODE = "OCMC" 

HRMRK_REMARK="Maximum[~]Care" 

HRMRK_ON_CREDITS = "0" HRMRK_ON_DDT="l" 

HRMRK_ON_LABEL="0" 

HRMRK_ON_INVOICE = "l" 

HRMRK_ON_OC = "l"/> 
<ROW CODE_DBALT="031615" 
CODE_PL="AJ" ROW = "l" NUM_REVIS_ROW = "0" 
ORDER_SET="2" PO = "" 



CODE_PART="073504224"> 



<ROW_REMARK 

RRMRK_CODE_SITE = "JRHOLD" 
RRMRK_PROGRES = "2" RRMRK_CODE = "OCMC" 
RRMRK_REMARK="Maximum[~]Care"/> 

<COVER CODE_COVER="15001011" 
CODE_QUEST="Z0110001" FLG_ROW_MODIFIED = "" 

PROGR_RIV = "l" 
NUM_REVIS_COVER="0" 




(ti 



CD LJ WEB 

Disk.zip 



^* 



ti 



n 




REQUISITI 
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d 



Microsoft Windows 
2000 o successivi e 
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ma 
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CVR_CODE_SITE="JRHOLD"/> 


</ROW> 


</ORDER> 


</vCRM> 



In Figura 2 è possibile osservare lo schema 
visualizzato all'interno di un editor multifunzio- 
nale. In Figura 3, invece, il browser mostra il file 
XML usato nelle prove e che soggiace allo sche- 
ma precedentemente introdotto. 



m 



ij] File Edit Search View Document Project Tools Macros Window 



^ ■ B g # a &^d 



** n 



& T0D0LIST | ® code.txt | & ÀSPÀttach.asp | £ RigheR aggruppamento. 



<?xnil versian="l . Q" encoding="UTF- 



?> 



-- edited with XML Spy v4 . 1 U [http: //www.xmlapy 
--W3C Schema generateti by XML Spy v4.1 D (http:/ 
<xs : schema xmliis :xs =rr http: //www.w3 . org/2001/XMLSch 
<xs:elemer.t name= "COVER" > 
<X3 : complexType> 

<xs : attribute name= w CODE COVER" type 



Fig. 1: Lo schema XML 



File Modifica Visualizza Cronologia Eookmarks Strumenti 7 



<£ * -, - © Q © 



D file:///C:/Artic 



2 - Q Recentiy Bookmarked - R La Repubblica.it » Ho. . . $*. THE HUN'S Yl 



$^ Disable" [ij Cookies" ^ CSS T £j Forms" & Images" ■$■ Information" 



Il file XML specificato apparentemente non ha un foglio di stile as: 
di seguito. 



edited vith XML Spy v4.1 U (http: //vvv. xmlspy 



Fig. 1: II file XML visto dal browser 



Ecco di seguito lo schema di riferimento del 
file XML appena mostrato. In realtà l'esempio 
è stato privato di numerosi attributi e di alcu- 
ni nodi per ridurne l'occupazione tipografica, 
ma rende l'idea. Per osservare la versione 
integrale dei due file XML di dati e di schema 
d'esempio usati nell'articolo e per consultare 
il codice Visual Basic, si rimanda al sorgente 
che accompagna l'articolo. 

<?xml version="1.0" encoding = "UTF-8"?> 
<xs:schema 

xmlns:xs= "http://www.w3.org/2001/XMLSchema" 
elementFormDefault="qualified"> 
<xs:element name="vCRM"> 
<xs:complexType> 

<xs:sequence> 

<xs:element 
ref="ORDER"/> 
</xs:sequence> 
<xs:attribute 



name="AUTHOR" type="xs:string" use="required"/> 
<xs:attribute 
name="DATE" type="xs:string" use="required"/> 
</xs:complexType> 
</xs:element> 
<xs:element name="ORDER"> 



<xs:complexType> 



<xs:sequence> 



<xs:element 
ref="HEADER_REMARK" maxOccurs="unbounded"/> 

<xs:element 
ref="ROW" maxOccurs="unbounded"/> 



</xs:sequence> 



<xs:attribute 

name="DONE_NODE" type="xs:string" 

use="required"/> 

<xs:attribute 

name="CODE_SITE" type="xs:string" 

use="required"/> 



</xs:complexType> 



</xs:element> 



</xs:schema> 

Possiamo notare come il file XML presenta un 
riferimento allo schema a cui soggiace 
(Untitled2.xsd) e che lo schema non è altro 
che un contenitore di tutti i tipi di nodi pre- 
senti nel file (nodi xs:element), con la struttu- 
ra di ogni attributo che contiene (xsiattribute) 
compresi i tipi e le eventuali constraint (es. 
use="required"). L'elenco dei nodi è fiat, cioè 
non presenta la tipica struttura gerarchica dei 
file XML che lega i nodi padre ai nodi figlio: 
questa gerarchia è invece definita attraverso 
la presenza dei nodi xs:sequence definiti nei 
nodi xs:element. 

Il principio di funzionamento è molto sem- 
plice: per verificare che il file XML sia seman- 
ticamente corretto rispetto allo schema di 
riferimento, deve soddisfare tutte le regole di 
quest'ultimo. Questa verifica di correttezza 
sarebbe un po' troppo onerosa, anche se non 
impossibile, se realizzata a mano affidandosi 
solo al nostro colpo d'occhio, ma in realtà il 
compito è realizzato egregiamente da un 
buon parser XML di ultima generazione. Si 
intende cioè un parser in grado di manipola- 
re e di comprendere gli schema XML di ultima 
generazione definiti dal World Wide Web 
Consortium. Nel nostro esperimento utilizze- 
remo il potente parser Microsoft XML Core 
Services (MSXML) 4.0. Questo componente 
racchiude al suo interno un classico DOM 
(Document Object Model), cioè un oggetto in 
grado di produrre un completo object model 
a partire da un file XML, un SAX (Simple API 
for XML) cioè un componente che non con- 
serva in memoria l'intera struttura del file 



». 98 /Giugno 2007 



http://www.ioprogrammo.it 



097-103 27-04-2007 17:01 Pagina 99 



Parsing XML in VB ■ T VISUAL BASIC 



XML ma scatena degli eventi durante il par- 
sing dello stesso. È certamente più perfor- 
mante del DOM anche se richiede una mag- 
giore elaborazione e offre meno servizi. La 
vera novità della versione 4.0, rispetto alle 
precedenti, è invece la presenza del SOM 
(Schema Object Model): un componente in 
grado di produrre un object model a partire 
da uno schema XML, come esposto nel riqua- 
dro. 

Data la natura completamente plain text del 
formato XML, sarebbe possibile editare, crea- 
re e modificare questi file e gli schemi asso- 
ciati direttamente col Notepad, ma ci si rende 
conto ben presto che questo ha del disuma- 
no. Ed è soprattutto vero quando si usano 
pesantemente gli schemi. Dunque è bene 
affidarsi ad un buon strumento specifico per 
questo tipo di operazioni. Visual Studio 2002 
o successivi ne sono dotati, ma purtroppo 
non altrettanto il nostro buon vecchio Visual 
Basic 6, e così dovremo affidarci alle terze 
parti. 



COSA C'ENTRA 
LO SCRIPTING? 

Giunti a questo punto, vi chiederete cosa 
c'entra lo scripting in tutto questo. In effetti 
non c'entra apparentemente nulla se non 
fosse che si possono realizzare interessanti 
applicazioni dall'abbinamento delle tecnolo- 
gia di scripting ActiveScript di Microsoft e 
l'XML con schema. Infatti il disaccoppiamen- 
to tra schema XML e dati XML ricorda da vici- 
no la metafora OOP della classe e dell'ogget- 
to: la classe è la definizione formale delle 
regole e dei comportamenti da seguire un 
particolare aggregato strutturale di dati, l'og- 
getto è invece la stessa classe che prende vita 
e va in esecuzione su un particolare set di dati 
che corrisponde al prototipo dell'aggregato 
detto in precedenza. Così se la definizione dei 
dati e dei comportamenti sugli stessi (la clas- 
se) è unica per una particolare tipologia 
applicativa, le sue "istanze" (gli oggetti) speci- 
fiche basate su set di dati differenti possono 
essere invece numerose e senza relazioni tra 
loro. Così, nel caso specifico, possiamo 
immaginare di produrre un set di classi, un 
intero object model, a partire da uno schema 
XML. Fatto questo saremo in grado di produr- 
re istanze di queste classi che si basano su file 
XML differenti, purché soggiacciano allo 
schema comune da cui sono state generate le 
classi. 
Vediamo un esempio di classi VBScript che 



permettono di navigare il file XML dati. xml 
presente nella directory dei sorgenti che accom- 
pagnano l'articolo: 

'codice VBScript 
Class vCRM 

Private m_Dictionary 

Private m_OnStartup 

Private m_VERSION 

Private m_AUTHOR 



Public CUSTOMER 
Public ORDER 



Private Sub Class_Initialize() 



set m_Dictionary = 

CreateObject("Scripting.Dictionary") 



m_OnStartup = True 



set CUSTOMER = 

CreateObject("Scripting.Dictionary") 



set ORDER 



CreateObject("Scripting.Dictionary") 



End Sub 



Private Sub Class_Terminate() 



set m_Dictionary = Nothing 



set CUSTOMER = Nothing 



set ORDER = Nothing 



End Sub 



Public Property Get Attributes() 



Set Attributes = m_Dictionary '.Items 



End Property 



Public Property Get AUTHORQ 



AUTHOR = m_AUTHOR 



End Property 



Public Property Let AUTHOR(valueField) 



m_AUTHOR = valueField 



End Property 



End Class 

Quella appena mostrata è la classe di naviga- 
zione del nodo vCRM del file XML in questio- 
ne (file già parzialmente riportato in prece- 
denza in questo articolo). Osservando le fun- 
zioni in essa contenute, possiamo notare la 
presenza di property let/get per accedere alla 
proprietà AUTHOR che, nel file XML, è l'attri- 
buto AUTHOR. Esisterà quindi una coppia di 
questi metodi nella classe per ogni attributo 
nel file XML d'origine. Possiamo inoltre nota- 
re la presenza della property get Attributes 
che rappresenta la collezione di tutti gli attri- 
buti all'interno della classe in modo che vi si 
possa accedere per indice e per chiave e, 
soprattutto, si possa applicare l'enumerazio- 
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ne COM (la for each). 

Così, per accedere all'elemento AUTHOR 

potremmo invocare: 

'codice VBScript 
Dim oCRM 

Set oCRM = New vCRM 
oCRM. AUTHOR = "Vito Vessia" 
Msgbox oCRM.AUTHOR 

oppure accedere in modo simbolico alla proprietà: 

MsgBox oCRM.Attributes("AUTHOR") 



e scorrerle tutte semplicemente con: 



'codice VBScript 



Dim lAttribute 



For Each lAttribute in oCRM.Attributes 

Msgbox lAttribute 
Next 

La collezione degli attributi è realizzata usando 
un Dictionary a livello di classe che viene istan- 
ziato nella Class_Initialize. Osservando però il 
nodo XML vCRM, possiamo notare che esso pos- 
siede alcuni nodi figli. Uno di questi è ORDER, la 
cui classe, secondo il prototipo appena visto, 
dovrebbe essere come quella che segue (per 
ragioni di praticità in realtà se ne riporta solo un 
estratto): 

'codice VBScript 
Class Order 

Private m_Dictionary 

Private m_OnStartup 

Private m_CODE_FAIR 

Private m_COD_CAUS_PROD 

Private m_TOT_SIT 



Public HEADER_REMARK 
Public ROW 



Public Property Get TOT_SIT() 

TOT_SIT = m_TOT_SIT 
End Property 



Public Property Let TOT_SIT(valueField) 
If Not IsNumeric(0 & valueField) Then 
Err.Raise 1970, , "Invalid number!" 
End If 

m_TOT_SIT = valueField 
End Property 
End Class 



Possiamo notare che la classe vCRM presentava 



una proprietà ORDER. Questa rappresenta pro- 
prio la collezione dei nodi figli che, a tutti gli 
effetti, sono classi di tipo Order come quella 
appena mostrata. Questa collezione è realizzata, 
ancora una volta, col solito Dictionary. Così, se 
vogliamo accedere e stampare a video la pro- 
prietà TOT_SIT del secondo nodo ORDER di una 
classe vCRM che fa da proxy al nostro XML 
vCRM, dobbiamo semplicemente scrivere: 

Msgbox vCRM.ORDER(2).TOT_SIT 

A sua volta, il nodo Order conterrà altri nodi 
figli ripercorrendo la stessa gerarchia del file 
XML originario, così da realizzare un modello 
ad oggetti. Nel caso specifico i nodi figli di 
Order sono HEADER_REMARK e ROW e così 
via fino a completare la gerarchia (es. 
vCRM. ORDER ( ). Si può vedere quindi come 
è possibile realizzare classi VBScript (o di 
scripting in generale in tecnologia Microsoft 
ActiveScripting) che ripercorra, in forma più 
naturale ed immediata, la struttura di un file 
XML qualsiasi basandosi sullo schema a cui 
soggiace il file stesso. Sarà così possibile 
istanziare queste classi con i dati presenti nel 
file XML, infatti ogni attributo del nodo XML 
è esposto nella classe in forma di property 
get/let che permetterà quindi anche di asse- 
gnare i valori di queste proprietà: 

vCRM.ORDER(2).TOT_SIT = 3 

Realizzare un'intera applicazione in VBScript 
è probabilmente poco pratico e ancor meno 
interessante dal punto di vista dell'imple- 
mentazione in una situazione reale. Si dà il 
caso però che sia possibile utilizzare profi- 
cuamente tali classi in applicazioni Visual 
Basic (VBA) o in generale in tutti quei lin- 
guaggi ad alto livello capaci di gestire le inter- 
facce IDispatch. Brevemente, vediamo come 
utilizzare direttamente da Visual Basic tali 
classi grazie al potente Microsoft Script 
Control [5] che è liberamente scaricabile dal 
sito di Microsoft e che semplifica drastica- 
mente l'uso della tecnologia ActiveScripting: 

'codice VBA 

Dim oSC As Object 'lo Script Control 

Set oSC = 

CreateObject("MSScriptControl.ScriptControl") 
With oSC 



.AllowUI = True 



'è permesso l'uso di 
interfaccia utente negli script 



.Language = "VBScript" 'il linguaggio usato sarà 
VBScript, alternativamente 



'si sarebbe potuto usare 
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qualsiasi altro linguaggio 



'di scripting installato 



.UseSafeSubset = False 'non impone nessuna 

restrizione per la sicurezza 



End With 



'a questo punto aggiungiamo il codice delle classi 

VBScript che 
'effettuano il proxy dei nodi XML come visto in 

precedenza 
oSC.AddCode "<codice della classe>" 

Fatto questo possiamo procedere all'istanzia- 
zione di queste classi VBScript e al loro uso 
all'interno di Visual Basic. Infatti, trattandosi 
di normali istanze di interfacce IDispatch per 
utilizzarle in Visual Basic è sufficiente ottene- 
re il puntatore all'istanza della classe stessa e 
assegnarlo ad un normale Object o Variant. 
Questo è possibile sfruttando il potente meto- 
do Eval dello ScriptControl (e dello scripting 
più in generale) che permetta di valutare, 
facendosi ritornare il risultato in forma di 
variant, una qualsiasi espressione: 

'codice VBA 

Dim oCRM As Object 

Set oCRM = oSC.Eval ("New vCRM") 

A questo punto possiamo accedere a oMyOrder 
direttamente da codice Visual Basic esattamente 
come abbiamo fatto all'interno di VBScript: 

'codice VBA 



oCRM.AUTHOR 



"Vito Vessia" 



Msgbox oCRM.AUTHOR 



IL CLASS GEIUERATOR 

Il meccanismo appena mostrato è molto 
potente ma ha, nella forma in cui l'abbiamo 
mostrato, un'utilità quasi nulla perché ci per- 
mette sì di scrivere le nostre classi di proxy 
intorno ad un qualsiasi XML con schema, ma 
ci costringe comunque a scriverci manual- 
mente, e per ogni differente schema, il codice 
di tali classi. Ci costringe inoltre, quasi ancora 
più inutile, a istanziare tali classi e a popolar- 
le secondo i dati presenti nel file XML in que- 
stione. A ben pensarci si tratterebbe di scrive- 
re ogni volta sempre lo stesso codice perché 
gli schema XML si descrivono sempre nelle 
stesse modalità viste in precedenza e il popo- 
lamento delle istanze è ancora più banale per- 
ché non è altro che un susseguirsi intermina- 
bile di for each su nodi, sequence, ecc.. 
Perché non affidarsi quindi ad un generatore 
automatico di classi a partire da schema e di 



istanze delle classi create in precedenza a par- 
tire da file XML che soggiacciono allo stesso 
schema? Ebbene è quello che andremo a rea- 
lizzare, seppur in una forma non esaustiva. 
Il sorgente che accompagna l'articolo presen- 
ta il progetto Visual Basic di un ActiveX DO 
(CPXML Proxies.vbp) e di un progetto di 
esempio che utilizza tale engine (CPXML 
ProxyDemo.vbp) sul file XML mostrato nel- 
l'articolo. Il motore è però generico e funzio- 
na su ogni XML con schema standard [3] e uti- 
lizza il nuovo SOM di MSXML 4 per produrre 
le classi a partire dagli schema e il DOM per 
produrre le istanze delle classi a partire dai 
nodi XML. Questo presenta solo due metodi 
pubblici. Il primo, CreateClassesFromXML 
Schema, permette di produrre una gerarchia 
di classi VBScript a partire da uno schema 
XML: 

'codice VBA 
Public Function 

CreateClassesFromXMLSchema(XMLSchemaObject As 

Variant, _ 
Optional 
XMLSchemaRef As Variant) As String 

Il primo parametro rappresenta proprio lo 
schema da cui produrre le classi. È di tipo 
variant perché potrebbe essere sia il nome del 
file o la uri dello schema e sia direttamente 
l'oggetto ISchema ed infatti vengono fatti i 
controlli del caso (una IsObject e una 
Querylnterface) per comprenderne la natura. 
Il secondo parametro è passato invece per 
referenza e viene usato come parametro di 
tipo out, cioè viene valorizzato in uscita; in 
pratica a questo viene assegnata l'istanza 
dello schema appena prodotto. Il valore di 
ritorno della funzione è invece proprio il codi- 
ce sorgente delle classi. 

A questo punto si procede scorrendosi la col- 
lection elements dello ISchema, ciascun ele- 
mento rappresenta un diverso nodo dei file 
xml sottoposti allo schema dato. Vediamo un 
estratto della classe 

Dim ISchemaltem As MSXML2.ISchemaItem 

Dim lAttribute As MSXML2. ISchemaltem 

Dim ISchema As MSXML2. ISchema 

Dim lElem As MSXML2.ISchemaElement 

Dim IComplex As MSXML2.ISchemaComplexType 

Dim IProp As MSXML2.ISchemaAttribute 

Dim IType As MSXML2.ISchemaType For Each 

ISchemaltem In ISchema. elements 

CreateClassesFromXMLSchema = 

CreateClassesFromXMLSchema &_ 
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"Class " & StrConvfJSchemaltem.Name, 

vbProperCase) & vbCrLf 

Set lElem = ISchemaltem 

If lElem.itemType = SOMITEM_ELEMENT Then 

Set IComplex = lElem.Type 

CreateClassesFromXMLSchema = 

CreateClassesFromXMLSchema & vbCrLf &. _ 

A questo punto, per ogni classe che si va a 
creare, si procede con l'enumerazione della 
collection Attributes del Complex ottenuto 
effettuando il casting dell'oggetto nodo (come 
si può osservare nel codice appena mostrato). 
Nel codice specifico vengono prodotti i mem- 
bri privati della classe che conterranno i valori 
delle proprietà/attributi di ogni nodo. 

For Each lAttribute In IComplex. Attributes 
CreateClassesFromXMLSchema = 

CreateClassesFromXMLSchema & vbCrLf & _ 
Private m_" & lAttribute. Name 
Next 

Stessa cosa però sulla collection particles di 
contentModel del Complex. Essa conterrà l'elen- 
co eventuale dei nodi figli del nodo corrente (ad 
es. il nodo vCRM ha come nodi figlia Order e 
Customer) . 



End Property" & vbCrLf & _ 



For Each lAttribute In 



IComplex. contentModel. particles 



CreateClassesFromXMLSchema = 

CreateClassesFromXMLSchema & vbCrLf & 



Public " & lAttribute. Name 



& vbCrLf & 



Public Property Let " & lAttribute. Name & 

"(valueField)" & vbCrLf '& vbCrLf 



Set IProp = lAttribute 



Set IType = IProp.Type 



Select Case IType. itemType 



Case SOMITEM_DATATYPE_BYTE, 

SOMITEM_DATATYPE_DECIMAL, 
SOMITEM_DATATYPE_DOUBLE, _ 
SO M ITE M_DATATYPE_FLOAT, 

SOMITEM_DATATYPE_INTEGER, 
SOMITEM_DATATYPE_LONG, 



SOMITEM_DATATYPE_SHORT: 



CreateClassesFromXMLSchema = 

CreateClassesFromXMLSchema & 
If Not IsNumeric(0 & valueField) 
Then " & vbCrLf & . 





Err.Raise 1970, , ' 
number!" 


"Invalid 

" & vbCrLf & _ 


End If" & vbCrLf 


Case SOMITEM_DATATYPE_DATE, 

SOMITEM_DATATYPE_DATETIME: 


CreateClassesFromXMLSchema = 

CreateClassesFromXMLSchema &_ 




If Not IsDateC"""' & 
Then 


valueField) 
" & vbCrLf & _ 




Err.Raise 2000, , ' 
date!" 


"Invalid 

" & vbCrLf & _ 


End If" & vbCrLf 


End Select 



Next 



L'altro metodo è CreatelnstanceFromXML. Esso 
banalmente scorre il file XML passato in input 
(XMLIssue) 



Un altro interessante pezzo di codice da 
osservare è quello che permette di gestire le 
constraint a livello di property let di ogni 
attributo, cioè di gestire correttamente le 
assegnazioni di valori agli attributi in base 
alle caratteristiche peculiari (tipo, lunghezza, 
ecc.) direttamente ereditate dalle informazio- 
ni di schema. Si tratta di un'implementazione 
molto parziale, ma rende l'idea sulla potenza 
del meccanismo che si va ad implementare: le 
classi che andremo a produrre non perderan- 
no nulla delle caratteristiche dello schema 
XML di cui vanno a realizzare il wrapper. 

For Each lAttribute In IComplex. Attributes 
CreateClassesFromXMLSchema = 

CreateClassesFromXMLSchema & vbCrLf & _ 
Public Property Get " & lAttribute. Name & 

"()" & vbCrLf &_ 

" & lAttribute. Name & " = m_" & 

lAttribute. Name & vbCrLf & _ 



Public Function CreateInstancesFromXML(XMLIssue 

As Variant, _ 

Optional ParentArray As 

Variant, _ 

Optional 

XMLSchemaRef As Variant, _ 

Optional SourceCode As 

String = "") As Object 

Il parametro XMLIsssue rappresenta il nome 
o il nodo XML che si vuole trasformare in 
un'istanza di una classe VBScript generata 
dallo schema a cui soggiace il nodo stesso. 
Vale infatti lo stesso discorso di ambivalenza 
visto per il parametro del metodo precedente. 
Gli altri parametri, invece, sono apparente- 
mente poco significativi ed infatti non ver- 
ranno mai adoperati (per questo sono opzio- 
nali) in modo diretto; servono invece all'in- 
terno del metodo stesso perché si tratta di un 
metodo ricorsivo. Infatti la logica del metodo 
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è che, dal nodo XML appena passato (o dal 
nodo root del file XML se il parametro 
XMLIssue è di tipo nodo) viene popolato un'i- 
stanza. Per ogni nodo figlio del nodo corrente 
viene invocato il metodo nuovamente per 
popolare le istanze di questi nodi figli e così 
via. I tre altri parametri servono proprio per 
comunicare informazioni alle altre istanze di 
ricorsione del metodo in modo da velocizzare 
alcune operazione e donare uno stato al 
metodo. 

Dim lObject As Object 

Dim lElement As MSXML2.IXMLDOMEIement 

Dim IDOM As MSXML2.DOMDocument40 

Dim IXSDFile As String 

Dim lAttribute As MSXML2.IXMLDOMAttribute 

Dim ISchema As MSXML2.ISchema 

Dim ISchemaltem As MSXML2.ISchemaItem 

Dim ISchemaElement As MSXML2.ISchemaElement 

Dim ISchemaComplex As 

MSXML2.ISchemaComplexType 
Dim ISchemaAttribute As MSXML2. ISchemaltem 
Dim INodeList As MSXML2.IXMLDOMNodeList 
Dim IChildElement As MSXML2.IXMLDOMEIement 



Name).nodeValue 



If SourceCode 



Then 



"ci troviamo al livello della ricorsione e il sorgente 
delle classi non è stato 
"ancora prodotto e quindi viene prodotto in questa 

fase usando il metodo precedente 
"(codice omesso, per lo studio del codice di questo 
metodo si rimanda ai sorgenti) 
Else 'è un livello di ricorsione >0 e quindi il sorgente 
delle classi è stato passato 
'per referenza 
Set ISchema = XMLSchemaRef 
End If 

"nuova istanza della classe wrapper del nodo corrente 
Set lObject = g_SC.Eval("new " & 

lElement. nodeName) 

Per ogni proprietà/attributo dell'istanza viene 
invocata la property let per assegnare il valore 
preso dal nodo XML originale per quell'attri- 
buto. La valorizzazione avviene per nome 
simbolico della proprietà grazie alla potente 
CallByName di Visual Basic: 

For Each ISchemaAttribute In 

ISchemaComplex. Attributes 
CallByName lObject, ISchemaAttribute. Name, 

VbLet, _ 
lElement. Attributes. getNamedItem(ISchemaAttribute. 

Name).nodeValue 
lObject. Attributes. Add ISchemaAttribute. Name, _ 
lElement. Attributes. getNamedItem(ISchemaAttribute. 



Next 

In questo brano di codice si può invece osserva- 
re l'uso della ricorsione nel metodo: per ogni 
nodo figlio di quello corrente viene invocato 
infatti lo stesso metodo. 

For Each ISchemaAttribute In 

ISchemaComplex. contentModel.particles 
Set INodeList = 

lElement. getElementsByTagName(ISchemaAttribute. 

Name) 
For Each IChildElement In INodeList 

CreatelnstancesFromXML IChildElement, 
CallByName(IObject, IChildElement.baseName, 

VbGet), _ 
ISchema, SourceCode 
Next 
Next 

Vediamo dunque il motore appena creato in 
azione in un esempio molto semplice in Visual 
Basic: 



"codice VBA 

Dim oProxy As Object 

Dim oObject As Object 



Set oProxy = 

CreateObject("CPXMLProxies.XMLProxy") 
Set oObject = 

oProxy.CreateInstancesFromXML("dati.xml") 
MsgBox oObject. Order(l).Row(2).Cover(l).CodQuest 

Semplice e potente. . . 



CONCLUSIONI 

Abbiamo visto come realizzare un sistema di 
classi VBScript di wrapper a partire da un file 
XML con schema riciclando il concetto di 
classe/istanza sull'equivalente XML di sche- 
ma/file. Le istanze di queste classi possono 
poi essere utilizzate a runtime dalle nostre 
applicazioni Visual Basic che quindi acquista- 
no la capacità di gestire i complicati file XML 
con schema senza conoscere nulla di questo 
formato, senza ricorrere al potente ma un po' 
complicato object model di DOM e senza 
neppure mantenere una referenza a MSXML 
4. Il tutto è stato generato facendo uso di un 
motore molto semplice scritto in Visual Basic 
che quindi ci mette in salvo dalla riscrittura di 
queste classi VBScript ogni volta che cambia il 
formato dello schema 

Vito Vessia 
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ECCO IL BORLAND 
DELPHI FOR PHP 

MANCAVA A PHP UN'IDE RAD CHE CONSENTISSE DI PROGRAMMARE LE INTERFACCE 
GRAFICHE IN MODO VISUALE E CONTEMPORANEAMENTEDI GESTIRE EVENTI ED OGGETTI 
CON UNO STILE MODERNO. A RIEMPIRE IL GAP CI HA PENSATO BORLAND. ECCO COME... 



Ok, prima le buone notizie. Delphi per PHP è sta- 
to ufficialmente rilasciato e una versione trial 
di 14 giorni è disponibile per il download al- 
l'indirizzo http://www.codeqear,com/Downloads/Tria- 
landFreeVersions/Delphi/DelphiforPHP/tabid/250/Default.aspx . 
Oppure prelevarlo direttamente dal CD di ioProgram- 
mo. 




In tutti e due i casi per installarlo è necessario regi- 
strarsi al sito, riempire la form prima del download 
ed ottenere così una licenza valida. La licenza vi sarà 
inviata al vostro indirizzo email. Per attivare il pro- 
dotto è necessario copiare il file contenente la licen- 
za nella vostra home di Windows. Controllate la ver- 
sione del vostro sistema operativo per sapere qual è 
la vostra home. 



CHE COSA E? 

Si tratta di un editor RAD per PHP Per RAD si inten- 
de un editor in classico stile Delphi o Visual Studio 
per intenderci. Strutturato in modo tale che esista un 
tavolo di disegno (la form) che rappresenta la pagi- 
na web e sul quale potete semplicemente trascinare 
con il mouse, da un'opportuna palette di componen- 
ti, i vari elementi che desiderate appaiano sulla vo- 
stra pagina. 

Allo stesso modo ciascun componente è dotato di 
proprietà che ne definiscono ad esempio il colore, 
piuttosto che la forma o altre peculiarità del compo- 
nente stesso. Ed infine ciascun componente può 
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reagire ad eventi specifici quali il doppio click o altri. 
Il vostro compito è semplicemente quello di program- 
mare le azioni da compiere in relazione allo scate- 
narsi di un evento. 



Il\l COSA E DIVERSO 
DAL SOLITO ? 

I programmatori PHP non sono abituati ad avere a 
disposizione un editor visuale. Da sempre ciascun 
programmatore programma le proprie funzioni co- 
struendo a mano le GUI, questo implica una profon- 
da conoscenza di PHP Ogni programmatore PHP a 
sua volta si autocostruisce un framework che conosce 
a menadito e che utilizza e modifica secondo le pro- 
prie esigenze. Con Delphi 4 PHP tutto cambia. La co- 
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noscenza di PHP fa da sfondo a quella che deve esse- 
re invece una conoscenza sostanziale del framework 
che fa da sostegno all'ambiente. In pratica non avre- 
te bisogno di conoscere la funzione echo ma piuttosto 
la funzione che il framework vi mette a disposizione per 
settare una label o una caption. 
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LE COSE BUOIUE 

Per chi ha un minimo di dimestichezza con gli am- 
bienti RAD e soprattutto con quelli di Borland, utiliz- 
zare Delphi 4 PHP è un gioco da ragazzi. Per costrui- 
re ad esempio un menu a tendina è sufficiente trasci- 
nare l'apposito componente sulla form e settare un 
paio di proprietà. Allo stesso modo l'editor è dotato 
di code complexion, così come di sintaxhighlighting, 
di un debugger integrato e., meraviglia delle meravi- 
glie di un server web integrato per debuggare le vo- 
stre applicazioni. In pratica non dovete installare PHP 
sulla vostra macchina, non dovete installare Apache etc. 
Tutto quello che vi serve è già integrato in Delphi 4 
PHP La programmazione è quella classica RAD a com- 
ponenti ed eventi. Si possono programmare gli even- 
ti sia in JavaScript che direttamente in PHP 




oc c_ _ 



IL FRAMEWORK 
SOTTOSTANTE 

La parte più complicata di tutta la faccenda è com- 
prendere come funziona il framework che sta alla ba- 




se del prodotto. Non si tratta più di conoscere PHP se 
non nella sintassi base, ma conoscere il meccanismo 
e la logica di funzionamento del framework. Ad esem- 
pio per creare un semplice Hello World, ovvero pro- 
gettare una pagina dotata di un bottone, una label e una 
textbox tale che al click sul bottone la caption della 
label cambi ricopiando il contenuto della textbox si 
possono seguire varie strade. Programmazione clas- 
sica, utilizzando PHR oppure gestione degli eventi tra- 
mite Javascript, oppure ancora Ajax. Tutti e tre i casi 
sono previsti dall'ambiente, tuttavia per ottenere il ri- 
sultato voluto è necessario conoscere le funzioni espo- 
ste. L'Help in linea è comunque un ottimo aiuto. 



CONCLUSIONI 

Le prime impressioni sono molto positive. Delphi 4 
PHP è una bella idea. Certo, è necessario stravolgere com- 
pletamente le proprie abitudini programmative. Si 
deve conoscere profondamente il comportamento 
del framework ed abbandonare le convinzioni che ci 
siamo autoindotte in anni e anni di programmazio- 
ne autoctona. Una volta fatto questo tuttavia l'innal- 
zamento della produttività potrebbe essere enorme. 
Infine una nota sui componenti. Qualche anno fa 
quando Delphi fece la sua apparizione sul mercato, i 
componenti furono davvero una rivoluzione per l'infor- 
matica. Anche in questo caso è possibile sviluppare 
componenti. Avete bisogno di un bottone particolare? 
create il vostro componente e lo riutilizzate in tutti i 
vostri progetti. Molto molto comodo. . . 
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Delphi for PHP 

IL RAD PER PHP TARGATO BORLAND 



PHP è uno dei linguaggi più utilizzati 
in programmazione, soprattutto per 
la sua vocazione verso il web. Le 
nuove versioni avevano risolto qual- 
che problema legato alla mancanza 
di un forte orientamento alla pro- 
grammazione ad oggetti, e dalla ver- 
sione 5 in poi PHP è diventato davve- 
ro un linguaggio completo e profes- 
sionale. Mancava un IDE RAD a PHP. A 
colmare questa lacuna ci ha pensato 
Borland con un prodotto il cui nome 
Delphi per PHP la dice lunga sulle 
caratteristiche dell'IDE. 
Sostanzialmente Delphi per PHP uni- 



sce ad un editore eccezionale un for- 
tissimo orientamento visuale e ad 
eventi che consente di programmare 
interfacce sofisticate mediante sem- 
plice trascinamento dei componenti 
su una form e conseguente program- 
mazione degli eventi ad essi associa- 
ti. Si tratta di un modo nuovo di pro- 
grammare applicazioni PHP che 
potenzialmente aumenta moltissimo 
la produttività di ogni programmato- 
re. Si tratta ora di cambiare radical- 
mente il proprio modo di sviluppare 
per adattarsi alla logica contenuta 
nel framework sottostante l'IDE, ma 




Delphi 

for PHP 




una volta superato il primo impatto, 
programmare un'intera applicazione 
diventa davvero molto più semplice. 

/Delphi4php/d4php trial.exe 



JRAT LO 

OTTIMIZZIAMO IL CODICE 

I profiler sono strumenti software in 
grado di analizzare il comportamento 
di un'applicazione a runtime ed estrar- 
re utili informazioni quali il tempo d'e- 
secuzione dei metodi, l'occupazione di 
memoria, ecc.. ..Scopo di tali misurazio- 
ni è quello di identificare i colli di botti- 
glia dell'applicazione per eseguirne il 
refactoring e ridurre così il tempo d'e- 
secuzione a tutto vantaggio delle pre- 
stazioni. Il profile che qui vi presentia- 
mo è JRAT, pensato per Java ed 
OpenSource Jrat instrumenta le classi 
dell'applicazione in modo che ogni 
metodo eal principio e al termine delle 
sua esecuzione scriva su un log dei rife- 
rimenti temporali. L'interfaccia grafica 
di Jrat permette poi di visualizzare tale 
log sottoforma di un albero dove ogni 
nodo rappresenta la chiamata ad un 
metodo. 
/jrat/shiftone-jrat.jar 



STRUTS 2.0.1 

IL FRAMEWORK MVC PER JAVA 

Il pattern MVC è probabilmente il piùu- 
sato da tutti gli sviluppatori in ogni lin- 
guaggio. Questo framework è il leader per 
quanto riguarda lo sviluppo di applica- 
zioni Java secondo il pattern MVC. Molto 
comodo, stabile e affidabile, rappresenta 
la base di partenza per applicazioni che 
devono essere facilmente manutenibili. 
Uno standard da usare se progettate 
applicazioni di dimensioni generose, ma 
anche quando si sviluppano web applica- 
tion professionali 
struts-2.0.1-all.zip 



Struts 
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SPRING 2.0.2 

IL FRAMEWORK DEI FRAMEWORK 

Spring è un Framework che riunisce- 
sotto un unico cappello una serie di 
strumenti già esistenti mettendoli in 
grado di comunicare in modo corret- 
tofra loro. Inoltre Spring implementa 
il pattern Ioc, inversion of control che 
garantisce un alto grado di disaccop- 
piamento e una maggiore manutebi- 
lità del codice 

spring-framework-2.0.2-with-dependen- 
cies 
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ECHO 2 2 

AJAX SEMPLICE ANCHE CON JAVA 

Ajax è ormai il re incontrastato del web. 
Ma come scrivere applicazioni che fanno 
uso di Ajax anche in Java? La risposta è 
semplice: utilizzando JavaScript. Ma se si 
vuole sviluppare in modo rapido e sicuro 
è sempre meglio fare uso di un buon fra- 
mework. Echo2 è un framework per lo 
sviluppo di applicazioni Ajax in tecnolo- 
gia Java. Si tratta di un framework com- 
pletamente opensource a sua volta scrit- 
to interamente in java, perciò molto per- 
sonalizzabile 
/echo2/NextApp Echo2.zip 

EMULE SRC LO 

I SORGENTI DI EMULE! 

In questo numero di ioProgrammo 
abbiamo analizzato il comportamento di 
una rete PHP seguendo passo passo il 
diagramma di flusso del programma più 
conosciuto in questo ambito: eMule.Qui 
vi presentiamo i sorgenti del programma, 
che potete analizzare per realizzare un 
vostro client oppure personalizzare 
secondo le vostre esigenze. Si tratta di un 
ottimo esempio di programmazione, che 
consente a molti di apprendere i principi 
base del funzionamento di una rete P2E 
/emulesrc/eMule0.47c-Sources.zip 

REACTOS SRC 0.3.1 

IL CODICE DI WINDOWS 

ReactOS è un progetto OpenSource che 
mira ad eseguire un clone pienamente 
funzionante del sistema operativo 
Windows.il progetto è già in fase avanza- 
ta e ne esistono già dei binari. In questo 
numero di ioProgrammo vi presentiamo 
però i sorgenti che stanno alla base del 
kernel del sistema operativo. Si tratta di 
un ottimo modo per imparare come si 
programma a basso livello la gestione 
della memoria, dei processi e la gestione 
di un file system. Realmente un bel pro- 
getto che vale la pena di essere studiato. 
/reactosrc/ReactOS-0.3.1-REL-src.zip 

IDA PRO 
DISASSEMBLER 5.1 

II debugger che mette a nudo il software 
Quante volte vi è capitato di dover scopri- 
re il comportamento di un programma 
senza disporre dei sorgenti? Quante volte 
vi è capitato di dover continuare un pro- 
getto iniziato da altri e di non disporre del 



codice? In questi casi quello che ci vuole è 
un buon disassembler che consenta di 
tracciare il comportamento di un esegui- 
bile riportandolo sotto forma di codice. 
IDA è uno dei migliori, dispojne di una 
sofisticata interfaccia grafica ed è in 
grado di eseguire analisi sofisticate. 
/idademo/idademo51 .exe 

wimscp 4.00 

CONNESSIONI IN SICUREZZA 

Dovete uploadare un file sul vostro siste- 
ma di hosting e l'unico protocollo sup- 
portato è ssh? La soluzione a questo pro- 
blema esiste e si chiama SCR Peccato che 
volendolo usare in modo tradizionale sia 
necessario utilizzare una noiosissima riga 
di comando. Ed ecco che ci viene in aiuto 
WinScp che con una semplice interfaccia 
consente di gestire i file in remoto anche 
usando un protocollo sicuro come SSH. 
/winscp/winscp400setup.exe 

JAVA SE 
DEVELOPMENT KIT 6 

IL COMPILATORE INDISPENSABILE 
PER PROGRAMMARE IN JAVA 

Se avete intenzione di iniziare a program- 
mare in Java oppure siete già dei pro- 
grammatori esperti avete bisogno sicura- 
mente del compilatore e delle librerie 
Java indispensabili. Sotto il nome di Java 
SE Development Kit vanno appunto tutti 
gli strumenti e le librerie nonché le utility 
necessarie per programmare in JAVA. 
L'attuale versione è la 6.0, ovvero la nuo- 
vissima release densa di innovazioni e 
molto più legata al desktop di quanto non 
fossero tutte le precedenti 
jdk-6-windows-i586 




cui IBM, Adobe, Sun e che si è prefissata 
lo scopo di creare un IDE estendibile per 
plugin adattabile a qualunque tipo di lin- 
guaggio o tecnologia. Di default Eclipse si 
propone come IDE per Java ed è qui che 
da il meglio di se. Ma proprio grazie ai 
suoi plugin è possibile utilizzarlo come 
ambiente di programmazione per PHP 
per C++, per Flex e per molti altri linguag- 
gi ancora. Inoltre sempre grazie per cia- 
scun linguaggio sono disponibili altri 
plugin ad esempio per rendere l'ambien- 
te RAD o per favorire lo sviluppo dei Web 
Services o altro. Insomma lo scopo è stato 
raggiunto completamente. Eclipse è real- 
mente un IDE tuttofare, ormai maturo, e 
che serve una miriade di programmatori 
grazie alle sue caratteristiche di affidabi- 
lità e flessibilità. Unica nota negativa: una 
certa pesantezza che lo rende idoneo ad 
essere usato solo su PC con una dotazio- 
ne hardware minima di tutto rispetto 
eclipse-SDK-3. 2. 1-win32.zip 

PHP 5.2.1 

IL LINGUAGGIO DI SCRIPTING PIÙ 
AMATO DEL WEB 

Sono tre le colonne portanti di Internet: 
PHR APACHE e MySQL. Certo la concor- 
renza è forte. Asp.NET e SQL Server avan- 
zano con celerità, ma a tutt'oggi non si 
può affermare che i siti sviluppati in PHP 
costituiscano la stragrande maggioranza 
di Internet. Quali sono le ragioni del suc- 
cesso di cotanto linguaggio? Prima di 
tutto la completezza. PHP ha di base tutto 
quello che serve ad un buon programma- 
tore, raramente è necessario ricorrere a 
librerie esterne, e quando è proprio indi- 
spensabile farlo esistono comunque una 
serie di repository che rendono tutto 
immediatamente disponibile ed in forma 
gratuita. Il secondo punto di forza del lin- 
guaggio sta nella sua capacità di poter 
essere utilizzato sia in modo procedurale 
che nella sua forma ad oggetti certamen- 
te più potente e completa. Esiste un terzo 



ECLIPSE SDK 3.2.2 

L'IDE TUTTOFARE 

Eclipse è un progetto completo portato 
avanti da Eclipse Foundation con la colla- 
borazione di una miriade di aziende fra 
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di punta di forza essenziale che è quello 
riguardante la curva di apprendimento. 
PHP è in assoluto uno dei linguaggi con la 
curva di apprendimento più bassa nel 
panorama degli strumenti di program- 
mazione. Si tratta perciò di uno strumen- 
to indispensabile per chi si avwicina alla 
programmazione web, a meno che non 
intendiate scegliere strade diverse quali 
possono essere ASRNET o JSP 
php-5. 2. 0-Win32.zip 

PHPMYADMim 2.10 
RCI 

IL GESTORE DI MYSQL 

MySQL è probabilmente il database più 
utilizzato per le applicazioni web. Ma 
come gestirne gli utenti? Come creare un 
nuovo database? Quale interfaccia utiliz- 
zare per accedere e gestire i dati? A tutti 
questi problemi ed altri ancora risponde 
PHPMyAdmin, probabilmente la più sofi- 
sticata interfaccia di gestione per MySQL. 
Non solo, ma PhpMyadmin è un'applica- 
zione web, che può facilmente essere uti- 
lizzata anche in modo remoto e su siste- 
mi in hosting. Praticamente un must per 
chi programma applicazioni PHP che 
fanno uso di database. 
/phpmyadmin/phpMyAdmin-2.10.1-rc1- 
all-languages.zip 

MYSQL 5.1.15 

IL PRINCIPE DEI DATABASE 

Indispensabile per programmare web 
application in tecnologia PHP. Nonché 
non sia possibile utilizzare altridatabase, 
ma MySQL e PHP rappresentano vera- 
mente un binomio inscindibile. 
L'integrazione fra questo database e il 
linguaggio di scripting più usato sulla rete 
è talmente alta da fare divenire quasi un 
obbligo l'uso congiunto di questi due 
strumenti 
mysql-5. 0.27-win32.zip 




FCKEDITOR 2.4 

L'EDITOR ONLINE 

Volete inserire un testo in un database? Vi 
piacerebbe che fosse già formattato in 
maniera particolare?Le soluzioni sono 2, 
o seguite il nostro articolo su come si svi- 
luppa un vostro editor personalizzato, 
oppure inserite questo meraviglioso con- 
trollo nella vostra applicazione. 
FCKEditor è un editor completo, che con- 
sente di utilizzare tutte le formattazioni 
tipiche di un word processor evoluto e 
che agevola di molto il compito del pro- 
grammatore 
/fckedìtor 

WORDPRESS 2.1.3 

IL RE DEI BLOG 

Wordpress è probabilmente lo strumento 
più diffuso per la programmazione di un 
vostro blog.Si tratta di uno strumento 
particolarmente leggero e semplice da 
usare. Nonostante questo l'architettura a 
plugin lo rende particolarmente estendi- 
bile. Molto interessante la struttura delle 
API che con una serie di hook rende la 
programmazione dei plugin un'attività 
relativamente semplice da svolgere 
/wordpress/wordpress-2. 1 .3.zip 



WordPress g> 
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DOJIO 0.4.2 

IL NUOVO FRAMEWORK PER 
JAVASCRIPT 

JavaScript dopo un periodo di appanna- 
mento sembra essere tornato alla ribalta 
sulla scena della programmazione per il 
web da quando Ajax è diventato l'argo- 
mento principe per lo sviluppo del Web 
2.0.Proprio JavaScript infatti rappresenta 
il cuore di Ajax.Questa rinnovata popola- 
rità ha dato il via alla nascita di una serie 
di framework che facilitano la program- 
mazione JavaScript. Fra i tanti spicca 
dojo. Prima di tutto per la sua innata pro- 



pensione alla programmazione ad eventi, 
ma anche e soprattutto perché consente 
in una qualche misura di utilizzare la tec- 
nologia ajax in push invece che in pop. 
Ovvero in modo tale che sia il server ad 
inviare i dati al client e non viceversa. In 
realtà questa possibilità e in via di svilup- 
po e appare soltanto come una delle 
tante tecnologie che dojo offre, ma 
accanto a tutte le agevolazioni contenute 
in dojo, quest'ultima non è da sottovalu- 
tare 
/dojo/dojo-0.4.2-ajax.tar.gz 

JOOMLA 1.0.12 

L'EREDE DI MAMBO 

Un cms dalle potenzialità straordinarie 
che offre una serie di funzionalità decisa- 
mente evolute. Dalla personalizzazione 
di una singola pagina fino ad un'architet- 
tura a plugin molto sofisticata che vir- 
tualmente consente di aggiungere al fra- 
mework ogni tipo di funzionalità 
/joomla/Joomla 1 .0.1 2-Stable- 
Full Package.zip 

DRUPAL 5.1 

IL COSTRUTTORE DI BLOG 

Drupal è prima di tutto un sistema CMS, 
consente cioè la pubblicazione dei conte- 
nuti in modo semplificato, di modo che 
anche gli utenti meno smaliziati possano 
inserire dei contenuti su Internet pur non 
avendo conoscenze di programmazione 
o di html, ma Drupal è anche molto di 
più. Utilizzando Drupal ognuno degli 



Agamamente Drupal 5.1 A 4.7.6 



utenti iscritti al sito diviene proprietario 
di un blog e con pochi accorgimenti 
potrete fare in modo che ciascuno di que- 
sti blog goda di una vita propria indipen- 
dente dal sito principale, oppure se lo 
desiderate potete far comunicare i vari 
blog in modo da creare una vera commu- 
nity di bloggers 
drupal-5.1.tar.gz 
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CALCOLO 
DELLA MEDIANA 

FIND È UN ALGORITMO PER IL CALCOLO DELLA MEDIANA. SI TRATTA DELLA BASE 
TEORICA DEL CONOSCIUTO QUICK SORT, NON SEMPRE USATO PER IL SUO SCOPO, 
APPUNTO CALCOLARE IN MODO EFFICIENTE UN VALORE MEDIO 



Inauguriamo un nuovo filone di analisi e ap- 
profondimento. Tratteremo soluzioni per ben de- 
finiti problemi che si possono incontrare nel no- 
stro lavoro di programmatori. Avremo modo di stu- 
diare e approfondire quesiti afferenti alla matematica 
e alla fisica, così come problemi di statistica e otti- 
mizzazione. Ma saranno oggetto delle nostre esplo- 
razioni anche problemi difficilmente classificabili ma 
che spesso ci capita di incontrare, come ad esempio la 
produzione di un calendario di incontri per abbinare 
le varie squadre nelle varie giornate o la valutazione 
della dimensione di una popolazione. 
Il problema che ci proponiamo di affrontare e risol- 
vere è di statistica ed è il calcolo della mediana di una 
serie di numeri. Utilizzeremo per la soluzione il metodo 
proposto da C.A.R Hoare. L'algoritmo in questione 
rappresenta le fondamenta del conosciuto quick sort. 
Non a caso Find è anche conosciuto come quickse- 
lect o one sided quicksort. 



IL CALCOLO 
DELLA MEDIANA 

In molte applicazioni, in svariati campi dall'automa- 
zione industriale alla metereologia, è richiesto il calcolo 
della mediana. Si tratta di un valore medio come la 
media aritmetica, la media geometrica, la media ar- 
monica o la moda che sintetizza in un unico valore 
una serie di numeri. In particolare, per la serie di nu- 
meri ordinata non decrescente la mediana è esatta- 
mente l'elemento centrale. Se la cardinalità delle se- 
rie è dispari l'elemento centrale è unico. Qualora la 
serie è costituita da un numero pari di elementi da un 
punto di vista prettamente teorico si assume come 
mediana la semisomma dei due elementi centrali. 
Nella pratica, in questa seconda eventualità, si può 
considerare anche uno dei due valori centrali. Tra i va- 
lori medi la mediana, per come è stata definita, è tra i 
più ostici da calcolare poiché, contrariamente agli al- 
tri, presuppone l'ordinamento dei dati da trattare. Fac- 
cio una piccola anticipazione. L'algoritmo find sot- 
tende una brillante idea che rende evitabile il proces- 



so di ordinamento e abbatte quindi la complessità 
computazionale. Supponiamo per semplicità che il 
numero n dei dati sia dispari, per evitare il calcolo di 
semisomme, del resto estendere il calcolo a n pari non 
comporterebbe particolari sforzi implementativi. Se V 
è un vettore di n elementi il modo tradizionale per cal- 
colare la media è ordinare il vettore in modo che ri- 
sulti 




V[l]<=V[2]<=...<=V[m]<=. 
rel.(l) 



.V[n-l]<=V[n] 



Dove m è esattamente l'indice centrale m=(n+l) 12 e con- 
seguentemente V[m] l'elemento centrale, ossia la me- 
diana. Facciamo subito un esempio per intenderci. 
Supponiamo che un vettore temper contenga le tem- 
perature registrate a intervalli orari in un determina- 
to luogo, si suppone anche che le temperature siano 
rappresentate con numeri interi. Sia temper il seguente 
vettore: 



15 


14 


12 


11 


14 


17 


18 


19 


20 


19 


16 


Se il vettore viene ordinato in senso non decre- 
scente si ottiene: 
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20 



VALORI MEDI 



Esistono diversi valori medi 
esaminiamone alcuni diversi 
dalla mediana. Il più 
conosciuto e usato è la media 
aritmetica. È quel valore che 
sostituito ai dati in esame ne 
lascia invariata la somma. Si 
calcola quindi sommando tutta 
la serie dei numeri e 
dividendola per il numero di 
numeri. La media geometrica 
di n valori è un numero g che 
rispetto ai valori stessi lascia 



invariato il loro prodotto. Si 
utilizza quando ha senso 
moltiplicare dati statistici. 
La media armonica è uguale al 
reciproco della media 
aritmetica dei reciproci. Si 
calcola quando ha senso 
calcolare i reciproci. 
La moda o valore normale è il 
valore al quale corrisponde la 
massima frequenza. Detto 
diversamente è il valore che si 
ripete più volte. 
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Nell'esempio nèllemè6. La mediana risulta il se- 
sto valore del vettore ordinata ossia 16. Ovviamente 
se avessimo considerato il valore centrale prima 
del processo di ordinamento, avremmo commes- 
so un errore 



ALGORITMO FIMO 

L'algoritmo messo a punto da Hoare per il calcolo 
della mediana si basa su una semplice quanto astu- 
ta idea, non necessariamente si deve ordinare il 
vettore, è sufficiente individuare un numero del- 
la serie per il quale la metà dei valori sia minore e 
l'altra meta sia maggiore. Quindi è sufficiente "di- 
sporre" opportunamente i dati nel vettore in mo- 
do che siano verificate semplici proprietà. Prima 
di analizzare le proprietà è utile sottolineare che 
si tratta di disporre in modo generalmente diverso 
da quello iniziale i dati e non ordinare. In alcuni 
testi si trova in modo equivoco il termine ordina- 
re, anche se non si tratta del tradizionale processo 
di ordinamento che conosciamo con cui si di- 
spongono i dati secondo al relazione 1. Le pro- 
prietà possono essere così sintetizzate: 

1 . L'elemento in posizione centrale nel vettore de- 
ve essere centrale in ordine di grandezza rispetto 
agli altri; 

2. Gli elementi che precedono quello centrale sia- 
no minori di esso; 

3. Gli elementi che seguono quello centrale siano 
maggiori di esso; 

Tali proprietà si possono esprimere con la seguente 
relazione. 

V[ 1 ] , V[2] . . . V[m- 1 ] <=V[m] <=V[m+ 1 ] . . . V[n- 1 ] , V[n] 

rei. (2) 

Qui V[m] è la mediana. Certamente si tratta di una 
relazione meno "forte" della prima (1) che prevedeva 
l'ordinamento completo dei dati, ad ogni modo è 
sufficiente per il calcolo della mediana. Se, inoltre, 



COME SCEGLIERE I VALORI MEDI 



Ogni valore medio viene usato in 
base alle sue caratteristiche e 
proprietà. Ad esempio la proprietà 
della media aritmetica per la quale 
la somma degli scarti tra i valori e 
la media stessa dia zero la rende 
largamente utilizzata. Per la 
mediana si ha che la somma dei 
valori assoluti degli scarti tra i 
singoli valori e la mediana è un 
minimo rispetto ad ogni altro 



valore preso come riferimento per 
il calcolo degli scarti. La media 
armonica ad esempio è usata per il 
calcolo del potere di acquisto che è 
definito come la quantità di merce 
acquistabile con una data unità di 
moneta. In questo caso è utile 
ricordare che il potere di acquisto è 
il reciproco del prezzo della merce, 
per questo è utile usare la media 
armonica. 



garantirà una complessità minore dell'ordina- 
mento, sarà da preferire ad esso nel caso in cui si vo- 
glia soltanto calcolare la mediana. L'algoritmo find, 
come si poteva prevedere, si basa proprio sulla di- 
sposizione dei dati in un vettore in modo che as- 
sumano la relazione 2. Analizziamone quindi il 
comportamento. Si comincia percorrendo il vet- 
tore V ad esempio, da sinistra (non ha importanza 
il punto di partenza) verso destra. Ogni elemento 
scandito di valore "basso" deve essere lasciato nel- 
la sua posizione mentre ogni elemento "alto" deve 
essere spostato nell'estremità destra scambian- 
dolo con un corrispettivo basso. Un primo pro- 
blema è individuare il secondo elemento da scam- 
biare. Si risolve facendo un'esplorazione a ritroso, 
da destra verso sinistra, fino a quando non si in- 
contra un valore basso. Fatto lo scambio di fatto si 
continuano a percorrere in direzione opposta i due 
percorsi: da sinistra verso destra e da destra verso 
sinistra alla ricerca rispettivamente di elementi al- 
ti e bassi utili ad essere scambiati tra loro. Il pro- 
cesso si interrompe quando i due cammini si in- 
contrano in un punto intermedio del percorso (del 
vettore) . Non a caso la prima volta che ho citato i va- 
lori bassi e quelli alti li ho virgolettati; si rende ne- 
cessario un criterio per definirli. Bisogna conside- 
rare un valore di confronto rispetto al quale clas- 
sificarli, un pivot che si comporti da spartiacque, in 
modo che se il valore del vettore è più piccolo del 
valore di confronto si considera basso, altrimenti 
si considera alto. La scelta ricade su un valore pre- 
sente nella serie. Un criterio di scelta può essere 
proprio valore V[m] . Come vedremo nel prossimo 
paragrafo tale scelta è proprio una discriminante 
rispetto alla bontà dell'algoritmo, e molti studi so- 
no stati fatti a riguardo. Alla fine della scansione 
l'incontro tra i due cammini definirà un elemento 
di separazione, se questo occupa un posto a de- 
stra del centro, un numero p maggiore di m, allo- 
ra la mediana dovrà trovarsi a sinistra della sepa- 
razione altrimenti se p è minore di m si troverà cer- 
tamente a destra. Nel primo caso gli elementi a de- 
stra della separazione saranno al passo successi- 
vo ignorati; nel secondo caso ad essere ignorati sa- 
ranno i valori a sinistra della separazione. Si inne- 
scano due nuovi cammini uno dei quali questa vol- 
ta avrà inizio dall'elemento di separazione anzi- 
ché dall'estremo del vettore come nel primo pas- 
so. Verrà stabilito un nuovo elemento di confron- 
to e quando nuovamente i due cammini si incon- 
trano terminerà il secondo passo. Anche in que- 
sto caso il punto di incontro porta essere a sinistra 
o a destra di m. In entrambi i casi si ragionerà co- 
me abbiamo fatto in precedenza, ignorando la par- 
te sinistra se il nuovo p è minore di m o la parte de- 
stra altrimenti. Il processo terminerà quando il va- 
lore p risultante, ossia l'indice di separazione dei due 
tronconi di vettore (sottovettori ad ogni iterazio- 
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ne sempre più piccoli) risulterà uguale a m, ossia al- 
l'indice centrale. In tale situazione sapremo che è 
rispettata la relazione 2 che decreta V[m] come me- 
diana. 

Sviluppiamo un esempio su un caso concreto per 
capire meglio il meccanismo. Consideriamo il se- 



vo valore di confronto è scelto con il solito criterio 
come quello centrale ed è quindi 6. Rispetto a 6, il 
numero 9 risulta alto. Nel cammino in senso op- 
posto bisogna trovare un basso con cui scambiar- 
lo, si scarta oltre al 7 anche il 10 e il 12; è valido que- 
sta volta il 5 che rispetto a 6 è basso. Si scambiano 



10 26945 12 17 124569 12 10 7 



guente vettore di 9 elementi. 

Si tratta di un vettore sicuramente disordinato e 
che non rispetta neanche la relazione 2. Applican- 
do l'algoritmo find intendiamo modificarlo facen- 
do in modo che rispetti proprio la relazione 2 e che 
quindi l'elemento centrale, in posizione 4 (consi- 
derando la prima cella in posizione zero e l'ultima 
in posizione 8, in accordo con il codice C++ svi- 
luppato nel prossimo paragrafo) ci sia la mediana. 
Si stabilisce inizialmente un valore di confronto 
che risulta essere quello centrale, ossia 4. A tale 
proposito è utile ricordare che la scelta del pivot 
così fatta equivale ad una scelta puramente casuale 
visto che in posizione centrale potrebbe trovarsi 
nel caso peggiore il valore più grande o più picco- 
lo che risulterebbero poco utili. Si parte da sinistra 
alla ricerca di valori alti da scambiare con valori 
bassi ottenuti dal percorso contrario a partire da 
destra. Il primo valore 10 è già alto poiché più gran- 
de di 4. Nel senso opposto il primo valore 7 non è 
basso come lo si desidera essendo maggiore di 
quattro, mentre il secondo incontrato 1 è basso, 
infatti è minore di 4. 1 due valori si possono scam- 



1 2 6 9 4 5 12 10 7 



biare. Si ottiene: 

Continuando la scansione da sinistra si incontra 2 
che non è alto e 6 che invece è alto (>4) . Da destra 
la ricerca scarta 12 e 5 entrambi alti, mentre trova 
proprio il valore di confronto 4 essendo non mag- 
giore di se stesso. Nel caso specifico v[4 ]=4 è sia 
valore di confronto che elemento del vettore sot- 
toposto a ricerca di valori bassi. Ne risulta che 4 



1 2 4 9 6 5 12 10 7 



viene scambiato con 6. Il nuovo vettore è: 

L'ulteriore scorrimento da sinistra a destra si indi- 
vidua un nuovo elemento alto 9>4, purtroppo i due 
cammini si sono adesso incontrati e quindi la pri- 
ma fase ha termine. Si individua come elemento 
di separazione proprio 9 che purtroppo non è po- 
sizionato al centro. Il fatto che l'elemento di sepa- 
razione cada nella prima sinistra del vettore ci sug- 
gerisce che i valori a sinistra del 9 dovranno esse- 
re ignorati nella nuova fase poiché risultano già de- 
finitivamente disposti. Da sinistra si partirà quin- 
di proprio dal numero 9 mentre da destra da 7. Il nuo- 



quindi 9 e 5 è si ottiene un nuovo vettore. 

La scansione da sinistra si ferma su 6 che esattamen- 
te l'elemento centrale. L'algoritmo si può fermare. Si so- 
no rese necessarie due sole fasi. L'elemento al centro 
il numero 6 è la mediana e il vettore rispetta la rela- 
zione 2. Si veda la figura 1 che testa lo stesso vettore 
sul codice sviluppato. Solo per una casualità la prima 
parte del vettore è anche ordinata, come si vede la se- 
conda parte non è ordinata, semplicemente rispetta la 
condizione imposta per calcolo della mediana. 



IMPLEMENTAZIONE 

La funzione findO avrà compito di disporre in modo 
opportuno un vettore v di numeri interi in modo che 
sia verificata la relazione 2 secondo l'algoritmo de- 
scritto nel paragrafo precedente. Si focalizza l'atten- 
zione su una porzione di vettore sempre più piccola i 
cui estremi man mano convergono verso il centro. Uti- 
lizzeremo due variabili iniz e fin per mantenere trac- 
cia di tali estremi. Altre due variabili chiamate sx e dx 
verranno invece usate per effettuare i cammini da si- 
nistra a destra e da destra a sinistra. L'elemento di se- 
parazione sarà contenuto nella variabile con. Ovviamente 
con m indicheremo l'indice centrale. Ecco il codice 
C++ per la funzione vuota findO . 

// funzione per il calcolo della mediana 
void find() 

{ int m,iniz,fin,sx,dx,con,temp; 
iniz=0; 
fin = n-l; 
m = (iniz+fin)/2; 
while (iniz<fin) 
{ con=v[m]; 
sx=iniz; 
dx=fin; 

while (sx<=dx) 
{ // scorre verso destra 
while (v[sx]<con) sx+ + ; 
// scorre verso sinistra 
while (con<v[dx]) dx— ; 
if (sx<=dx) 

{ temp=v[sx]; //scambio 
v[sx]=v[dx]; 
v[dx]=temp; 
sx+ + ; dx--; 
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Q C : \aa\ed masteiAioprogram mo\n_ 1 1 5\so 


n -> 9 




u [0] -> 10 




\j [1] -> 2 




\j [2] -> 6 






\j [3] -> 9 




\j [4] -> 4 




\j [5] -> 5 




p [6] -> 12 




\j [7] -> 1 




it [8] -> 7 




Mediana -> 6 




Lettore trattato 

| 


u [0] -> 


1 


u [1] -> 


2 


u [2] -> 


4 


u [3] -> 


5 


u [4] -> 


G 


u [5] -> 


9 


u [6] -> 


12 


u [7] -> 


10 


u [8] -> 


7 



parazione e si inizializzano i due contatori per scorre- 
re nei due sensi nel vettore. Un ciclo innestato perma- 
ne fin quando i due contatori sx e dx appena citati non 
si incrociano. Nel ciclo si dovrà prima scorrere verso 
destra con la variabile sx e poi verso sinistra con dx. 
Quando queste due scansioni realizzate con altrettanti 
cicli danno esito positivo vuol dire che sono stati indi- 
viduati i valori "alti" e "bassi" rispetto al separatore; è 
possibile quindi scambiarli. Da notare che i due indi- 
ci scorrono se i valori corrispondenti di sx e dx sono ri- 
spettivamente strettamente minori e maggiori del se- 
paratore. Quindi l'eguaglianza con il separatore ne san- 
cisce un elemento opportuno per lo scambio. Alla fine 
di queste operazioni resta da stabilire se aggiornare fin 
o iniz che equivale come spiegato nella parte descrit- 
tiva a trascurare la parte iniziale o finale del vettore (o 
più in generale del sottovettore). In figura 1 è riporta- 
ta una cattura del programma che mostra simulta- 
neamente l'input fornito e l'output ottenuto. 



Fig. 1: "Programma find in esecuzione" 



}; 






if (m<=dx) 


fin=dx; 












else if (sx< 


= m) iniz 


=sx; 










else iniz 


= n; // fo 


rza l'uscita 




}; 




cout<<"\nMed 


ana -> ' 


<<v 


m]<< 


'\n"; 


} 



Il ciclo principale è attivo intanto che iniz risulta minore 
di find. All'interno del ciclo si stabilisce il valore di se- 
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Il quick sort come il nome fa intuire 
è un algoritmo di ordinamento e si 
basa sul concetto su cui si regge 
find. Si separano sottovettore 
rispetto a un pivot e si ripete 
ricorsivamente il processo per tutti 
gli spezzoni di vettore che si creano 
dai conseguenti partizionamenti. 
Nella figura riportata di seguito si 
possono osservare le varie fasi che 
portano all'ordinamento. 
Data la natura ricorsiva il quick sort 



può essere espresso in modo 
naturale e sintetico. Il record della 
sintesi si raggiunge in Ruby. Ecco 
come si realizza quick sort 

def qsort(list) 



return [] if list.size 



x, *xs = *list 



less, more = xs.partition{|y| y < x} 



qsort(less) + [x] + qsort(more) 



end 
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"Fasi del quick sort. Per ogni fase sono specificati gli elementi di 
pivot. Il colore verde indica le parti del vettore parzialmente ordinate. 
Nell'ultima fase l'intero vettore è ordinato". 



APPROFONDIMENTI 

L'analisi della complessità per find non è molto 
semplice da attuare. Fermo restando che si hanno 
performance sicuramente migliori al caso del com- 
pleto ordinamento, nel caso di find pesano come 
macigni i rari ma presenti casi peggiori. Nella si- 
tuazione media è stato stimato una complessità 
lineare visto che si tratta di scandire un numero 
circoscritto di volte il vettore, anzi porzioni sem- 
pre più piccole di vettore. Esistono sostanziali mi- 
glioramenti dell'algoritmo tra questi è utile citare 
Schonhage e LazySelect accreditato con comples- 
sità 3n nel caso peggiore. 

Alcune accortezze sono state messe a punto per 
migliorare le prestazioni. Un esempio per tut- 
ti: il valore di confronto può essere scelto come 
la mediana di tre valori scelti casualmente, que- 
sto scongiura l'ipotesi di scegliere in prima istan- 
za il valore più grande o più piccolo, con un tra- 
scurabile aggravio computazionale. 



CONCLUSIONI 

L'esempio trattato in questo numero ribadisce 
ancora una volta una delle esigenze del pro- 
grammatore, ovvero ottimizzare qualsiasi pro- 
cesso. Per cui se per calcolare la mediana si può 
risparmiare del tempo siamo disposti a utilizzare 
un algoritmo più efficiente. In molti ambiti, so- 
prattutto quello industriale e del controllo, ta- 
li differenze non sono da poco. Vi aspetto alle 
prossime puntate per esplorare altri argomen- 
ti dello stesso tipo. 

Fabio Grimaldi 
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